← 返回目录

Replicate Flux MCP

社区

为开发者打造的高质量图像与SVG生成MCP服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 105 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 10 天前
工具数: 9

56FMRS · C

该服务器功能丰富，支持多种图像生成模式，但依赖Replicate API，需要付费令牌。配置简单，与主流客户端集成良好，但缺少自动化测试。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

12/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 证据：README和源码描述了一致的工具集，并声明使用MCP协议2025-11-25。但未提供测试套件，README自述'目前没有自动化测试'，仅通过构建和Inspector进行冒烟测试。因此关键路径的可复现性缺乏验证，错误处理细节未知。扣分：无测试，静态审查无法确认实际行为。
安全与权限 10/20: 证据：API令牌通过环境变量传递，未在文档或配置示例中泄露真实秘密。工具注解中设置了readOnlyHint/destructiveHint等，有禁用安全过滤器的选项但默认为false。run_replicate_model允许任意模型，但可通过REPLICATE_MODEL_ALLOWLIST限制，且默认未设置。扣分：未验证是否存在真正的确认机制，但未发现明显越权或恶意行为。
维护活跃度 12/20: 证据：仓库活跃，有105星、0开放问题，MIT许可证。有多个集成徽章和版本号。扣分：未提供提交频率、最近更新时间或安全问题响应渠道的具体证据，没有自动化测试和维护流程文档。
文档质量 14/20: 证据：README极其详尽，覆盖安装、集成、工具参数、环境变量、示例和故障排除。有双语版本。扣分：缺少成本说明（如API费用）、模型速率限制和更详细的错误处理文档。
安装易用性 12/20: 证据：提供了多种客户端（Cursor、Claude Desktop、Smithery、Glama、Codex）的配置示例，安装步骤清晰，可通过npx运行。扣分：静态审查无法验证setup的实际成功率，缺少自动化测试或CI证据。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要为代码项目快速生成视觉素材的开发者
希望在Claude Desktop或Cursor中直接调用AI图像生成功能的用户
需要结构化输出（如JSON）以便程序化处理的场景

不适合谁

完全离线的图像生成需求（依赖Replicate API）
对隐私要求极高，不能发送提示到外部服务的场景
需要免费无限生成的用户（Replicate API按用量计费）

所需权限

访问Replicate API（需要REPLICATE_API_TOKEN）
通过网络向Replicate发送生成请求和获取结果
读写本地配置文件和进程环境变量

风险与副作用

API密钥泄露可能导致未授权使用和费用损失
生成的图像可能包含不当内容（虽有安全过滤器但可能被绕过）
依赖外部服务，可能遇到网络延迟或服务不可用
运行任意模型（如run_replicate_model）可能产生意外成本和输出

安装接入

准备工作

运行环境：Node.js

REPLICATE_API_TOKEN 必填密钥 Replicate API 令牌，必需；在 replicate.com/account/api-tokens 创建，缺失时服务器直接退出。

其他可选配置项（3 个）

REPLICATE_IMAGE_MODEL_ID 可选可选；覆盖默认图像模型，值必须在内置图像模型允许列表中。

REPLICATE_SVG_MODEL_ID 可选可选；覆盖 generate_svg 使用的 SVG 模型，须在内置 SVG 允许列表中。

REPLICATE_MODEL_ALLOWLIST 可选可选；逗号分隔的 owner/name 列表，限制 run_replicate_model 可调用的模型；未设置=全部允许，设为空=全部拒绝。

在Replicate注册并获取API令牌。
根据你的MCP客户端选择集成方式：对于Claude Desktop，在配置文件（如mcp.json）中添加上述配置；对于Cursor，在.cursor/mcp.json中添加；对于Codex，在~/.codex/config.toml中添加。
替换REPLICATE_API_TOKEN为你的实际令牌。
重启客户端以生效。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add replicate-flux-mcp -e 'REPLICATE_API_TOKEN=YOUR TOKEN' -- npx -y replicate-flux-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cursor 中连接后，工具列表应出现 generate_image、generate_svg 等工具；然后发送一条自然语言图片生成请求验证能否返回图片 URL。

常见排障

认证错误：检查REPLICATE_API_TOKEN是否正确设置并有效
安全过滤器触发：修改提示词以避免敏感内容
超时错误：增加pollingAttempts或pollingInterval配置
模型覆盖无效：确保模型ID在允许列表内

试试这样问

连接成功后，可以直接对 AI 助手这样说：

生成一张日落时宁静山间湖泊的图片
为我的品牌生成一个现代简约风格的 logo SVG
用同一个提示词生成 4 张不同种子的变体图片，比如未来感的城市夜景
列出我最近的 Replicate 预测记录

工具能力 9

generate_image 写入

根据文本提示生成图像

generate_multiple_images 写入

根据多个提示生成多张图像

generate_image_variants 写入

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

generate_svg 写入

根据文本提示生成SVG矢量图形

prediction_list 只读

获取最近的Replicate预测列表

get_prediction 只读

获取特定预测的详细信息

run_model 写入

运行白名单内的Replicate模型（原始输入）

run_replicate_model 写入

运行任意Replicate模型（通过owner/name引用）

展开其余 1 个工具

get_model_schema 只读

获取Replicate模型的OpenAPI输入模式

使用场景

生成网站或应用所需的定制图片和SVG图标

批量生成多个概念的图像以用于设计探索

生成同一概念的多种风格变体，如水彩、油画等

调用Replicate上的任意模型，如视频生成、图像增强等

支持客户端

Claude Desktop

Cursor

Cline

Zed

Codex

依据项目文档列出，未经本站实测。

详细介绍

Replicate Flux MCP 是一个基于模型上下文协议（MCP）的服务器，使AI助手能够生成高质量的图像和矢量图形。默认使用 black-forest-labs/flux-schnell 生成位图，使用 recraft-ai/recraft-v3-svg 生成SVG。支持通过环境变量或工具内的模型ID覆盖来更换模型，并内置允许列表。提供批量生成、变体生成、任意Replicate模型调用、结构化输出、进度通知等功能。兼容Claude Desktop、Cursor、Cline、Zed等客户端。