Flux Cloudflare MCP

Flux Cloudflare MCP

site icon
2025.03.17 0
JavaScript图像生成AI 集成内容生成
Flux Cloudflare MCP 是一个基于 Model Context Protocol (MCP) 的服务器,通过 Cloudflare Worker API 提供 AI 助手使用 Black Forest Labs 的 Flux 模型生成高质量图像的能力。该服务支持多种 MCP 客户端(如 Cursor、Claude Desktop 等),并允许用户自定义图像生成的参数,如宽高比和推理步骤。
View on GitHub

Overview

🌟 基本能力

产品定位

Flux Cloudflare MCP 是一个专为 AI 助手设计的图像生成服务,通过 MCP 协议提供高质量的图像生成能力。

核心功能

  • 🖼️ 高质量图像生成:使用 Flux 模型生成图像
  • 🤖 无缝 AI 集成:支持 AI 助手直接生成图像
  • 🎛️ 可定制参数:控制宽高比、推理步骤等
  • 🔌 MCP 兼容:支持多种 MCP 客户端
  • 🔒 本地处理:通过 Cloudflare Worker 安全处理请求
  • 💬 聊天补全:使用相同 API 获取文本补全

适用场景

  • AI 助手需要生成图像的场景
  • 开发者在应用中集成图像生成功能
  • 需要快速原型设计的项目

工具列表

  • generate_image:根据文本提示生成图像
  • prompt:图像生成的文本描述
  • num_inference_steps:去噪步骤数(1-4)
  • aspect_ratio:宽高比(如 "16:9")

常见问题解答

  • 认证错误:检查 FLUX_API_TOKEN 是否正确设置
  • API 连接问题:确保 Flux API 可访问
  • 安全过滤器触发:修改提示以避免敏感内容

📦 使用教程

使用依赖

  • Node.js 环境
  • Cloudflare Worker 部署的 Flux 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

调试方式

  1. 确保环境变量 FLUX_API_TOKENFLUX_API_URL 正确设置
  2. 使用 MCP 客户端测试图像生成功能
  3. 检查 Cloudflare Worker 日志以排查问题

🔧 集成示例

Cursor 集成

  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"]
    }
  }
}
  1. 替换 YOUR_TOKENYOUR_API_URL
  2. 重启 Cursor

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。