适合谁
- 需要为代码项目快速生成视觉素材的开发者
- 希望在Claude Desktop或Cursor中直接调用AI图像生成功能的用户
- 需要结构化输出（如JSON）以便程序化处理的场景
R
56FMRS · C
该服务器功能丰富，支持多种图像生成模式，但依赖Replicate API，需要付费令牌。配置简单，与主流客户端集成良好，但缺少自动化测试。
Replicate Flux MCP 是一个基于模型上下文协议（MCP）的服务器，使AI助手能够生成高质量的图像和矢量图形。默认使用 black-forest-labs/flux-schnell 生成位图，使用 recraft-ai/recraft-v3-svg 生成SVG。支持通过环境变量或工具内的模型ID覆盖来更换模型，并内置允许列表。提供批量生成、变体生成、任意Replicate模型调用、结构化输出、进度通知等功能。兼容Claude Desktop、Cursor、Cline、Zed等客户端。
工具能力
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引用）
get_model_schema
获取Replicate模型的OpenAPI输入模式
安装接入
- 在Replicate注册并获取API令牌。2. 根据你的MCP客户端选择集成方式：对于Claude Desktop，在配置文件（如mcp.json）中添加上述配置；对于Cursor，在.cursor/mcp.json中添加；对于Codex，在~/.codex/config.toml中添加。3. 替换REPLICATE_API_TOKEN为你的实际令牌。4. 重启客户端以生效。
claude_desktop_config.json
{
"mcpServers": {
"replicate-flux-mcp": {
"command": "npx",
"args": [
"-y",
"replicate-flux-mcp"
],
"env": {
"REPLICATE_API_TOKEN": "YOUR TOKEN"
}
}
}
}
选型与风险
不适合谁
- 完全离线的图像生成需求（依赖Replicate API）
- 对隐私要求极高，不能发送提示到外部服务的场景
- 需要免费无限生成的用户（Replicate API按用量计费）
所需权限
- 访问Replicate API（需要REPLICATE_API_TOKEN）
- 通过网络向Replicate发送生成请求和获取结果
- 读写本地配置文件和进程环境变量
风险与副作用
- API密钥泄露可能导致未授权使用和费用损失
- 生成的图像可能包含不当内容（虽有安全过滤器但可能被绕过）
- 依赖外部服务，可能遇到网络延迟或服务不可用
- 运行任意模型（如run_replicate_model）可能产生意外成本和输出
常见排障
- 认证错误：检查REPLICATE_API_TOKEN是否正确设置并有效
- 安全过滤器触发：修改提示词以避免敏感内容
- 超时错误：增加pollingAttempts或pollingInterval配置
- 模型覆盖无效：确保模型ID在允许列表内
使用场景
生成网站或应用所需的定制图片和SVG图标
批量生成多个概念的图像以用于设计探索
生成同一概念的多种风格变体，如水彩、油画等
调用Replicate上的任意模型，如视频生成、图像增强等
支持客户端
Claude Desktop完整支持
Cursor完整支持
Cline完整支持
Zed完整支持
Codex完整支持