Flux cf

Flux Cloudflare MCP

功能强大的模型上下文协议（MCP）服务，可通过 Cloudflare Worker API 使用 Black Forest Labs 的 Flux 模型生成图像，为 AI 助手提供图像生成能力。

安装 • 功能 • 用法 • 文档 • 贡献

---

🌟 功能

• 🖼️ 高质量图像生成：使用 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

从源代码安装

# Clone the repository
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

# Install dependencies
npm install

# Build the project
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：具有 Workers AI 访问权限的 Cloudflare API 令牌
     • 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;                // Required: Text description of the image to generate
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "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 并进入 Settings
2. 导航到 "MCP" 或 "Model Context Protocol" 部分
3. 点击 "Add Server" 或对应选项
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

🛠 技术栈

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

⚙️ 配置

服务需要以下环境变量：

• FLUX_API_TOKEN：用于向 Flux API 进行身份验证的 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 许可，详情请参阅 LICENSE 文件。

🔗 资源

• Model Context Protocol 文档
• Cloudflare Workers 文档
• Flux 模型文档
• MCP TypeScript SDK
• snakeying/flux-api-worker - 简单的 Flux API 实现
• aigem/cf-flux-remix - 功能丰富且带有 Web UI 的 Flux API