Flux Cloudfare MCP

Flux Cloudflare MCP

一个强大的模型上下文协议（MCP）服务器，为AI助手提供使用 黑森林实验室的Flux模型 使用 Cloudflare Worker API。

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

______________________________________________________________________

🌟 特性

• 🖼️ 高质量图像生成：访问Flux，一种最先进的图像生成模型
• 🤖 无缝AI集成：使像Claude这样的人工智能助手能够直接生成图像
• 🎛️ 可定制参数：控制纵横比、推理步骤等
• 🔌 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

🚀 设置您的通量API

此MCP服务器需要Flux API端点才能运行。设置API有两个选项：

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

snakey/flux api工作人员 提供了一个简单高效的Cloudflare Worker来访问Flux模型：

1. 叉起 fluxapi工作库
2. 将其部署到Cloudflare Workers：

- 在Cloudflare仪表板中创建新的Worker - 将其连接到您的分叉存储库 - 设置所需的环境变量： - 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”）

1. 一旦部署，您的API将在 https://your-worker-name.your-subdomain.workers.dev
2. 使用此URL作为您的 FLUX_API_URL 以及您选择的API密钥作为 FLUX_API_TOKEN

选项2：使用aigem/cf flux rex进行部署

对于具有web UI的功能更丰富的实现，您可以使用 aigem/cf焊剂再混合:

1. 按照中的安装说明进行操作 cf flux混音库
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")
}

🔧 用法

光标集成

方法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"]
    }
  }
}

1. 替换 YOUR_TOKEN 使用您的实际Flux API代币和 YOUR_API_URL 使用API URL
2. 重新启动Cursor以应用更改

方法2：使用光标MCP设置

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

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

1. 替换 YOUR_TOKEN 使用您的实际Flux API代币和 YOUR_API_URL 使用API URL
2. 保存设置，必要时重新启动Cursor

Claude桌面集成

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API \_URL=YOUR_API_URL npx-y通量-响铃-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

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

🛠 技术栈

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

⚙️ 配置

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

• FLUX_API_TOKEN：使用Flux API进行身份验证的API令牌
• FLUX_API_URL：部署的Flux API的URL（来自snakeing/Flux-API-worker或aigem/cf-Flux-remix）

🔍 故障排除

常见问题

认证错误

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

API连接问题

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

安全过滤器已触发

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

🤝 贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

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

🔗 资源

• 模型上下文协议文档
• Cloudflare员工文档
• 通量模型文档
• MCP TypeScript SDK
• snakey/flux api工作人员 -简单Flux API实现
• aigem/cf焊剂再混合 -具有web UI的功能丰富的Flux API

](https://smithery.ai/server/@Hzzy2O/flux-cloudfare-mcp)