Cloudflare Edge Services

🚀 CF-MCP-Server 中文文档

基于 Model Context Protocol (MCP) 的图像生成服务实现，采用 Cloudflare Workers 构建，为用户提供标准化的图像生成服务接口。

🚀 快速开始

环境要求

• Node.js 18 及以上版本
• Wrangler CLI
• NPM 包管理工具

安装部署

# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env

# 部署Worker
pnpm deploy

✨ 主要特性

• 🖼️ 基于 MCP 协议的标准化服务接口
• 🚀 开箱即用的图像生成 Worker 模块
• 🔧 支持快速扩展自定义工具和资源
• ⚡ 边缘计算优化部署

📦 安装指南

环境要求

• Node.js 18 及以上版本
• Wrangler CLI
• NPM 包管理工具

安装部署

# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env

# 部署Worker
pnpm deploy

💻 使用示例

基础用法

在配置文件中配置图像生成接口：

{
"mcpServers": {
"generateImage": {
"command": "/Users/zhangxudong/Gits/turinhub/cf-mcp-server/mcp-image-generation/node_modules/.bin/workers-mcp",
"args": [
"run",
"generateImage",
"https://mcp-image-generation.turinhub.com",
"/Users/zhangxudong/Gits/turinhub/cf-mcp-server/mcp-image-generation"
],
"env": {}
}
}
}

📚 详细文档

模块构成

mcp-image-generation

graph LR
subgraph mcp-image-generation
A[Cloudflare Worker] --> B[Flux-1-Schnell 模型]
A --> C[图像生成API]
C --> D((4-8 steps))
end

• 支持步骤数范围：4 - 8 步骤
• 响应格式：Base64 编码的 PNG 图像
• 部署方式：Cloudflare Workers

API 文档

图像生成接口

配置示例:

{
"mcpServers": {
"generateImage": {
"command": "/Users/zhangxudong/Gits/turinhub/cf-mcp-server/mcp-image-generation/node_modules/.bin/workers-mcp",
"args": [
"run",
"generateImage",
"https://mcp-image-generation.turinhub.com",
"/Users/zhangxudong/Gits/turinhub/cf-mcp-server/mcp-image-generation"
],
"env": {}
}
}
}

参数说明:

开发指南

添加新工具

参考在线文档 官方案例代码库

1. 使用 MCP SDK 创建新 Worker：

npx create-cloudflare@latest my-new-worker
cd my-new-worker # 我总是忘记这一步
npm install workers-mcp
npx workers-mcp setup

⚠️ 重要提示

不要在项目本地 package.json 安装 wrangler，直接使用全局管理。

2. 实现工具逻辑后更新主服务配置
3. 使用 @modelcontextprotocol/inspector 测试 MCP

npx @modelcontextprotocol/inspector

🔧 技术细节

该项目是基于 Model Context Protocol (MCP) 的图像生成服务实现，采用 Cloudflare Workers 构建。mcp-image-generation 模块包含 Cloudflare Worker、Flux - 1 - Schnell 模型和图像生成 API，支持 4 - 8 步骤的图像生成，响应为 Base64 编码的 PNG 图像。通过标准化的 MCP 协议接口，实现了图像生成服务的标准化和快速部署，同时支持边缘计算优化，并且可以快速扩展自定义工具和资源。

📄 许可证

MIT License © 2025 Turinhub