Replicate Flux

MCP Replicate FLUX

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

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

功能特点

• 使用 Replicate 的 black-forest-labs/flux-schnell 模型生成图片

• 将生成的图片存储到 Cloudflare R2

• 返回可访问的图片 URL

• 支持自定义提示词和文件名

• 使用 Replicate 的 black-forest-labs/flux-schnell 模型生成图片

• 将生成的图片存储到 Cloudflare R2

• 返回可访问的图片链接

• 支持自定义提示词和文件名

前置要求

• Node.js（v16 或更高版本）

• Replicate API 令牌

• Cloudflare R2 存储桶和凭证

• npm 或 yarn

• Node.js（v16 或更高版本）

• Replicate API 令牌

• Cloudflare R2 存储桶和凭证

• npm 或 yarn

环境变量

.env 文件中需要设置以下环境变量：

.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

本地安装

通过 Smithery 安装

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

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

手动安装

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

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

# 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 设置，以允许公开访问上传的图片。

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

本地运行

在本地启动 MCP 服务：

在本地启动 MCP 服务器：

node index.js

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

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

使用方法

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

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

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

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

集成示例

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

以下是使用 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" }
  ]
}

测试

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

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

运行测试

node test.js

测试脚本将：

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

测试脚本将：

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 中的提示词，测试不同的图片生成场景。

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

Cursor MCP 配置

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

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

方法 1：完整配置

在 ~/.cursor/mcp.json 创建一个包含所有环境变量的文件：

在 ~/.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"
      }
    }
  }
}

方法 2：最小配置

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

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

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

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

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

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

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

注意事项

• 两种方式中的 description 字段均为可选

• 配置文件中的环境变量优先级高于系统环境变量

• 更改配置后，重启 Cursor 以应用更改

• 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 配置

4. 图片生成失败：检查您的 Replicate API 令牌和配额

5. R2 上传失败：验证您的 R2 凭证和存储桶权限

6. 无法访问生成的图片：确保您的 R2 存储桶具有正确的 CORS 配置

MCP 协议 协议说明

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

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

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

参考链接 参考链接

• 模型上下文协议文档
• Replicate API 文档
• Cloudflare R2 文档
• Flux AI 模型

许可证 许可证

MIT