MCP Replicate FLUX

使用 Replicate 的 FLUX 模型生成图片并存储到 Cloudflare R2 的模型上下文协议（MCP）服务器。

Features 功能特点

• 使用 Replicate 的 black-forest-labs/flux-schnell 模型生成图片
• 将生成的图片存储到 Cloudflare R2
• 返回可访问的图片链接
• 支持自定义提示词和文件名

Prerequisites 前置要求

• Node.js（v16 或更高版本）
• Replicate API 令牌
• Cloudflare R2 存储桶和凭证
• npm 或 yarn

Environment Variables 环境变量

.env 文件中需要的环境变量：

REPLICATE_API_TOKEN=your_replicate_token
STORAGE_ENDPOINT=your_r2_endpoint
STORAGE_ACCESS_KEY=your_r2_access_key
STORAGE_SECRET_KEY=your_r2_secret_key
STORAGE_BUCKET=your_bucket_name
STORAGE_DOMAIN=your_domain

Local Installation 本地安装

Installing via Smithery

要通过 Smithery 自动为 Claude Desktop 安装 MCP Replicate FLUX：

npx -y @smithery/cli install @andylee20014/mcp-replicate-flux --client claude

Installing manually 手动安装

按照以下步骤在本地设置项目：

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

# Install dependencies
npm install

# Create .env file and add your credentials
cp .env.example .env
# Edit .env with your actual credentials

确保您的 Cloudflare R2 存储桶具有适当的 CORS 设置，以允许公共访问上传的图片。

Running Locally 本地运行

要在本地启动 MCP 服务器：

node index.js

服务器将启动并通过标准输入/输出监听 MCP 协议消息。

Usage 使用方法

服务器提供了一个 generate-image 工具，接受两个参数：

• prompt：用于生成图片的文本提示词
• filename：生成的图片所需的文件名

Integration Example 集成示例

以下是使用 MCP 客户端库与此 MCP 服务器集成的示例：

const { McpClient } = require('@modelcontextprotocol/sdk/client/mcp.js')

async function generateImage(prompt, filename) {
  const client = new McpClient()
  // Connect to your running MCP server
  await client.connect(yourTransport)
  
  const result = await client.tools.call('generate-image', {
    prompt,
    filename
  })
  
  return result
}

示例响应：

{
  "content": [
    { "type": "text", "text": "Image successfully generated and uploaded to Cloudflare R2" },
    { "type": "image", "url": "https://your-domain.com/filename.jpg" }
  ]
}

Testing 测试

提供了一个测试脚本，用于验证图片生成和上传功能。

Running the test 运行测试

node test.js

测试脚本将：

1. 使用示例提示词生成图片
2. 将图片上传到 Cloudflare R2
3. 返回可访问的 URL

测试输出示例：

Generating image with prompt: "a beautiful girl"
Filename: test-1234567890.jpg
Image generated and uploaded successfully!
Image URL: https://your-domain.com/test-1234567890.jpg

您可以在 test.js 中修改提示词来测试不同的图片生成场景。

Cursor MCP Configuration Cursor MCP配置

在Cursor中配置MCP服务器有两种方式：

Method 1: Complete Configuration 完整配置方式

在 ~/.cursor/mcp.json 创建完整配置文件，包含所有环境变量：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"],
      "description": "使用Replicate的FLUX模型生成图片并存储到Cloudflare R2的MCP服务器",
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token",
        "STORAGE_ENDPOINT": "your_r2_endpoint",
        "STORAGE_ACCESS_KEY": "your_r2_access_key",
        "STORAGE_SECRET_KEY": "your_r2_secret_key",
        "STORAGE_BUCKET": "your_bucket_name",
        "STORAGE_DOMAIN": "your_domain"
      }
    }
  }
}

Method 2: Minimal Configuration 最小配置方式

如果你偏好单独管理环境变量（使用系统环境变量或 .env 文件），可以使用最小配置：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"]
    }
  }
}

使用最小配置时，请确保你的环境变量正确设置在以下位置之一：

• 系统环境变量
• 项目目录中的 .env 文件
• 云平台的环境变量（对于已部署的服务器）

注意事项

• description 描述字段在两种方式中都是可选的
• 配置文件中的环境变量优先级高于系统环境变量
• 更改配置后，需要重启Cursor以应用更改

项目结构

mcp-replicate-flux/
├── .env                  # Environment variables
├── index.js             # MCP server entry point
├── generateImage.js      # Image generation and R2 upload logic
├── test.js              # Test script
└── README.md            # Project documentation

故障排除

常见问题

1. 图片生成失败：检查您的 Replicate API 令牌和配额
2. R2 上传失败：验证您的 R2 凭证和存储桶权限
3. 无法访问生成的图片：确保您的 R2 存储桶具有正确的 CORS 配置

协议说明

模型上下文协议（MCP）是一种 AI 模型交互标准，可实现不同 AI 系统之间的互操作性。此服务器实现了一个 MCP 工具，可与任何兼容 MCP 的客户端一起使用。

有关 MCP 的更多信息，请访问: https://mcp.freeaigen.com/

参考链接

• Model Context Protocol Documentation
• Replicate API Documentation
• Cloudflare R2 Documentation
• Flux AI Model

许可证

MIT