
Flux Cloudflare MCP

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
调试方式
- 确保环境变量
FLUX_API_TOKEN
和FLUX_API_URL
正确设置 - 使用 MCP 客户端测试图像生成功能
- 检查 Cloudflare Worker 日志以排查问题
🔧 集成示例
Cursor 集成
- 编辑
.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"]
}
}
}
- 替换
YOUR_TOKEN
和YOUR_API_URL
- 重启 Cursor