Replicate Flux MCP

MCP 兼容许可证 TypeScript 模型上下文协议 smithery 徽章 NPM 下载量

Replicate Flux MCP 是一个高级的模型上下文协议（MCP）服务器，使 AI 助手能够生成高质量的图像和矢量图形。通过 Replicate API 利用 Black Forest Labs 的 Flux Schnell 模型生成光栅图像，以及 Recraft 的 V3 SVG 模型生成矢量图形。

📑 目录

入门与集成
功能
文档
- 可用工具
- 可用资源
开发
技术细节
故障排除
贡献
许可证
资源
示例

🚀 入门与集成

设置流程

获取 Replicate API 令牌
- 在 Replicate 注册
- 在账户设置中创建 API 令牌
选择集成方法
- 根据您首选的 MCP 客户端选择以下集成选项之一
让您的 AI 助手生成图像
- 自然地问：“你能生成一张日落时宁静山景的图像吗？”
- 或者更具体：“请创建一张显示宁静山景的图像，前景中有湖面反射日落色彩”
探索高级功能
- 尝试不同的参数设置以获得定制结果
- 使用 generate_svg 实验 SVG 生成
- 使用批量图像生成或变体生成功能

Cursor 集成

方法 1：使用 mcp.json

在项目目录中创建或编辑 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "env REPLICATE_API_TOKEN=YOUR_TOKEN npx",
      "args": ["-y", "replicate-flux-mcp"]
    }
  }
}

将 YOUR_TOKEN 替换为实际的 Replicate API 令牌
重启 Cursor 以应用更改

方法 2：手动模式

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

env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp

将 YOUR_TOKEN 替换为实际的 Replicate API 令牌
保存设置并在必要时重启 Cursor

Claude 桌面集成

在配置目录中创建或编辑 mcp.json 文件：

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": ["-y", "replicate-flux-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR TOKEN"
      }
    }
  }
}

将 YOUR_TOKEN 替换为实际的 Replicate API 令牌
重启 Claude 桌面以应用更改

Smithery 集成

此 MCP 服务器在 Smithery 上作为托管服务提供，允许您无需设置自己的服务器即可使用。

访问 Smithery 并创建账户（如果没有）
导航到 Replicate Flux MCP 服务器页面
点击“添加到工作区”将服务器添加到您的 Smithery 工作区
配置您的 MCP 客户端（Cursor、Claude 桌面等）以使用您的 Smithery 工作区 URL

有关在 MCP 客户端中使用 Smithery 的更多信息，请访问 Smithery 文档。

Glama.ai 集成

此 MCP 服务器也在 Glama.ai 上作为托管服务提供，提供了另一种无需本地设置即可使用的选项。

访问 Glama.ai 并创建账户（如果没有）
前往 Replicate Flux MCP 服务器页面
点击“安装服务器”将服务器添加到您的工作区
配置您的 MCP 客户端以使用您的 Glama.ai 工作区

有关更多信息，请访问 Glama.ai MCP 服务器文档。

🌟 功能

🖼️ 高质量图像生成 - 使用最先进的 AI 模型 Flux Schnell 创建令人惊叹的图像
🎨 矢量图形支持 - 使用 Recraft V3 SVG 模型生成专业的 SVG 矢量图形
🤖 AI 助手集成 - 无缝启用 Claude 等 AI 助手生成视觉内容
🎛️ 高级定制 - 通过控制宽高比、质量、分辨率等微调生成
🔌 通用 MCP 兼容性 - 适用于所有 MCP 客户端，包括 Cursor、Claude 桌面、Cline 和 Zed
🔒 安全的本地处理 - 所有请求都在本地处理，以增强隐私和安全性
🔍 全面的历史管理 - 跟踪、查看和检索您的完整生成历史
📊 批量处理 - 在单个请求中从不同提示生成多个图像
🔄 变体探索 - 创建并比较同一概念的多种解释
✏️ 提示工程 - 通过专门的提示修改微调图像变体

📚 文档

可用工具

`generate_image`

根据文本提示使用 Flux Schnell 模型生成图像。

{
  prompt: string;                // 必填：要生成的图像的文本描述
  seed?: number;                 // 可选：用于可重复生成的随机种子
  go_fast?: boolean;             // 可选：使用优化模型运行更快的预测（默认：true）
  megapixels?: "1" | "0.25";     // 可选：图像分辨率（默认："1"）
  num_outputs?: number;          // 可选：要生成的图像数量（1-4）（默认：1）
  aspect_ratio?: string;         // 可选：宽高比（例如，"16:9"，"4:3"）（默认："1:1")
  output_format?: string;        // 可选：输出格式（"webp"，"jpg"，"png"）（默认："webp"）
  output_quality?: number;       // 可选：图像质量（0-100）（默认：80）
  num_inference_steps?: number;  // 可选：去噪步骤数（1-4）（默认：4）
  disable_safety_checker?: boolean; // 可选：禁用安全过滤器（默认：false）
}

`generate_multiple_images`

根据提示数组使用 Flux Schnell 模型生成多个图像。

{
  prompts: string[];             // 必填：要生成的图像的文本描述数组（1-10 个提示）
  seed?: number;                 // 可选：用于可重复生成的随机种子
  go_fast?: boolean;             // 可选：使用优化模型运行更快的预测（默认：true）
  megapixels?: "1" | "0.25";     // 可选：图像分辨率（默认："1"）
  aspect_ratio?: string;         // 可选：宽高比（例如，"16:9"，"4:3"）（默认："1:1")
  output_format?: string;        // 可选：输出格式（"webp"，"jpg"，"png"）（默认："webp"）
  output_quality?: number;       // 可选：图像质量（0-100）（默认：80）
  num_inference_steps?: number;  // 可选：去噪步骤数（1-4）（默认：4）
  disable_safety_checker?: boolean; // 可选：禁用安全过滤器（默认：false）
}

`generate_image_variants`

从单个提示生成同一图像的多个变体。

{
  prompt: string;                // 必填：要生成变体的图像的文本描述
  num_variants: number;          // 必填：要生成的图像变体数量（2-10，默认：4）
  prompt_variations?: string[];  // 可选：应用于变体的提示修改器列表（例如，["水彩风格"，"油画风格"]）
  variation_mode?: "append" | "replace"; // 可选：如何应用变体 - 'append' 添加到基础提示，'replace' 直接使用变体（默认："append"）
  seed?: number;                 // 可选：基础随机种子。每个变体将使用 seed+variant_index
  go_fast?: boolean;             // 可选：使用优化模型运行更快的预测（默认：true）
  megapixels?: "1" | "0.25";     // 可选：图像分辨率（默认："1"）
  aspect_ratio?: string;         // 可选：宽高比（例如，"16:9"，"4:3"）（默认："1:1")
  output_format?: string;        // 可选：输出格式（"webp"，"jpg"，"png"）（默认："webp"）
  output_quality?: number;       // 可选：图像质量（0-100）（默认：80）
  num_inference_steps?: number;  // 可选：去噪步骤数（1-4）（默认：4）
  disable_safety_checker?: boolean; // 可选：禁用安全过滤器（默认：false）
}

`generate_svg`

根据文本提示生成SVG矢量图像，使用Recraft V3 SVG模型。

{
  prompt: string;                // 必填：生成SVG的文本描述
  size?: string;                 // 可选：生成的SVG的尺寸（默认："1024x1024"）
  style?: string;                // 可选：生成图像的风格（默认："any"）
                                // 选项："any", "engraving", "line_art", "line_circuit", "linocut"
}

`prediction_list`

从Replicate获取您最近的预测列表。

{
  limit?: number;  // 可选：返回的最大预测数量（1-100）（默认：50）
}

`get_prediction`

获取特定预测的详细信息。

{
  predictionId: string;  // 必填：要检索的预测ID
}

可用资源

`imagelist`

浏览使用Flux Schnell模型生成的图像历史记录。

`svglist`

浏览使用Recraft V3 SVG模型生成的SVG图像历史记录。

`predictionlist`

浏览您所有的Replicate预测历史记录。

💻 开发

克隆仓库：

git clone https://github.com/awkoy/replicate-flux-mcp.git
cd replicate-flux-mcp

安装依赖：

npm install

启动开发模式：

npm run dev

构建项目：

npm run build

连接到客户端：

{
  "mcpServers": {
    "image-generation-mcp": {
      "command": "npx",
      "args": [
        "/Users/{USERNAME}/{PATH_TO}/replicate-flux-mcp/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR REPLICATE API TOKEN"
      }
    }
  }
}

⚙️ 技术细节

技术栈

Model Context Protocol SDK - 核心MCP功能，用于工具和资源管理
Replicate API - 提供访问最先进的AI图像生成模型
TypeScript - 确保类型安全并利用现代JavaScript特性
Zod - 实现运行时类型验证，确保API交互的健壮性

配置

可以通过修改src/config/index.ts中的CONFIG对象来配置服务器：

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2",
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // 毫秒
};

🔍 故障排除

常见问题

认证错误

确保您的REPLICATE_API_TOKEN在环境中正确设置
通过直接使用Replicate API测试您的令牌是否有效

安全过滤器触发

模型内置了安全过滤器，可能会阻止某些提示
尝试修改您的提示，避免潜在的有问题内容

超时错误

对于较大的图像或繁忙的服务器，您可能需要增加配置中的pollingAttempts或pollingInterval
默认设置应适用于大多数用例

🤝 贡献

欢迎贡献！请按照以下步骤进行贡献：

Fork仓库
创建您的功能分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m 'Add some amazing feature'）
推送到分支（git push origin feature/amazing-feature）
打开Pull Request

对于功能请求或错误报告，请创建GitHub问题。如果您喜欢这个项目，请考虑给仓库点个星！

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

🔗 资源

🎨 示例

多个提示	提示变体

以下是一些如何使用这些工具的示例：

使用`generate_multiple_images`批量生成图像

使用不同的提示一次性创建多个不同的图像：

{
  "prompts": [
    "山区公路上的红色跑车", 
    "海滩上的蓝色跑车", 
    "城市街道上的复古跑车"
  ]
}

使用`generate_image_variants`生成图像变体

使用种子创建同一概念的不同解释：

{
  "prompt": "夜晚的未来城市天际线",
  "num_variants": 4,
  "seed": 42
}

或者使用提示修饰词探索风格变化：

{
  "prompt": "角色肖像",
  "prompt_variations": [
    "动漫风格", 
    "水彩风格", 
    "油画风格", 
    "3D渲染风格"
  ]
}

由Yaroslav Boiko用心制作 ❤️