Flux Cloudflare MCP

一个强大的模型上下文协议 (MCP) 服务器，它使 AI 助手能够通过 Cloudflare Worker API 使用 Black Forest Labs 的 Flux 模型 生成图像。

安装 • 特性 • 用法 • 文档 • 贡献

---

🌟 特性

• 🖼️ 高质量图像生成: 访问 Flux，一种最先进的图像生成模型
• 🤖 无缝 AI 集成: 使 Claude 等 AI 助手能够直接生成图像
• 🎛️ 可定制参数: 控制宽高比、推理步骤等
• 🔌 MCP 兼容: 适用于任何 MCP 客户端（Cursor、Claude Desktop、Cline、Zed 等）
• 🔒 本地处理: 所有请求都通过 Cloudflare Worker 安全处理
• 💬 聊天补全: 使用相同的 API 获取文本补全

📦 安装

使用 NPX 直接运行

FLUX_API_TOKEN=your_token FLUX_API_URL=your_api_url npx -y flux-cloudflare-mcp

从源代码

# 克隆仓库
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

# 安装依赖
npm install

# 构建项目
npm run build

🚀 设置您的 Flux API

此 MCP 服务器需要 Flux API 端点才能运行。 您可以通过两种方式设置 API：

选项 1：使用 snakeying/flux-api-worker 部署（推荐）

snakeying/flux-api-worker 提供了一个简单高效的 Cloudflare Worker，用于访问 Flux 模型：

1. Fork flux-api-worker 仓库
2. 将其部署到 Cloudflare Workers：
   • 在您的 Cloudflare 仪表板中创建一个新的 Worker
   • 将其连接到您 Fork 的仓库
   • 设置所需的环境变量：
     • API_KEY: 您选择的用于身份验证的 API 密钥
     • CF_ACCOUNT_ID: 您的 Cloudflare 帐户 ID
     • CF_API_TOKEN: 您的 Cloudflare API 令牌，具有 Workers AI 访问权限
     • FLUX_MODEL: 要使用的 Flux 模型（默认值："@cf/black-forest-labs/flux-1-schnell"）
3. 部署后，您的 API 将在 https://your-worker-name.your-subdomain.workers.dev 上可用
4. 使用此 URL 作为您的 FLUX_API_URL，并将您选择的 API 密钥作为 FLUX_API_TOKEN

选项 2：使用 aigem/cf-flux-remix 部署

对于具有 Web UI 的更丰富的功能实现，您可以使用 aigem/cf-flux-remix：

1. 按照 cf-flux-remix 仓库 中的安装说明进行操作
2. 部署后，您的 API 将在您部署的 URL 上可用
3. 使用此 URL 作为您的 FLUX_API_URL，并将您配置的 API 密钥作为 FLUX_API_TOKEN

📚 文档

可用工具

generate_image

使用 Flux 模型根据文本提示生成图像。

{
  prompt: string;                // 必需：要生成的图像的文本描述
  num_inference_steps?: number;  // 可选：去噪步骤数 (1-4)（默认值：4）
  aspect_ratio?: string;         // 可选：宽高比（例如，“16:9”、“4:3”）（默认值：“1:1”）
}

🔧 用法

Cursor 集成

方法 1：使用 mcp.json

1. 在您的项目目录中创建或编辑 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}

2. 将 YOUR_TOKEN 替换为您的实际 Flux API 令牌，并将 YOUR_API_URL 替换为您的 API URL
3. 重新启动 Cursor 以应用更改

方法 2：使用 Cursor MCP 设置

1. 打开 Cursor 并转到设置
2. 导航到“MCP”或“模型上下文协议”部分
3. 单击“添加服务器”或等效项
4. 在相应的字段中输入以下命令：

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

5. 将 YOUR_TOKEN 替换为您的实际 Flux API 令牌，并将 YOUR_API_URL 替换为您的 API URL
6. 保存设置并在必要时重新启动 Cursor

Claude Desktop 集成

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "npx",
      "args": ["-y", "flux-cloudflare-mcp"],
      "env": {
        "FLUX_API_TOKEN": "YOUR_TOKEN",
        "FLUX_API_URL": "YOUR_API_URL"
      }
    }
  }
}

💻 本地开发

1. 克隆仓库：

git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

2. 安装依赖：

npm install

3. 构建项目：

npm run build

🛠 技术栈

• 模型上下文协议 SDK - 核心 MCP 功能
• Cloudflare Workers - 用于图像生成的无服务器 API
• TypeScript - 类型安全和现代 JavaScript 功能
• Zod - 运行时类型验证

⚙️ 配置

服务器需要以下环境变量：

• FLUX_API_TOKEN: 您的 API 令牌，用于通过 Flux API 进行身份验证
• FLUX_API_URL: 您部署的 Flux API 的 URL（来自 snakeying/flux-api-worker 或 aigem/cf-flux-remix）

🔍 故障排除

常见问题

身份验证错误

• 确保您的 FLUX_API_TOKEN 在环境中正确设置
• 通过直接使用 Flux API 测试来验证您的令牌是否有效

API 连接问题

• 检查您的 Flux API (Cloudflare Worker) 是否正在运行且可访问
• 确保您的网络允许连接到 Cloudflare Workers

安全过滤器触发

• 该模型具有内置的安全过滤器，可能会阻止某些提示
• 尝试修改您的提示以避免潜在的问题内容

🤝 贡献

欢迎贡献！ 请随时提交 Pull Request。

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🔗 资源

• 模型上下文协议文档
• Cloudflare Workers 文档
• Flux 模型文档
• MCP TypeScript SDK
• snakeying/flux-api-worker - 简单的 Flux API 实现
• aigem/cf-flux-remix - 具有 Web UI 的功能丰富的 Flux API