Replicate Flux MCP

MCP 兼容
许可证
TypeScript
模型上下文协议

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 Desktop 集成

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

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

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

Smithery 集成

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

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

有关将 Smithery 与您的 MCP 客户端一起使用的更多信息，请访问 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 Desktop、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`

根据文本提示使用 Recraft V3 SVG 模型生成 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"
      }
    }
  }
}

⚙️ 技术细节

技术栈

模型上下文协议 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
默认设置应适用于大多数用例

🤝 贡献

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

分叉仓库
创建您的功能分支（git checkout -b feature/amazing-feature）
提交您的更改（`git commit -m '添加一些神奇的功能'）
推送到分支（git push origin feature/amazing-feature）
打开拉取请求

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

📄 许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

🔗 资源

🎨 示例

多个提示	提示变体

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

使用 `generate_multiple_images` 进行批量图像生成

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

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

使用 `generate_image_variants` 进行图像变体

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

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

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

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

由 Yaroslav Boiko倾情打造 ❤️