使用说明
项目简介
Replicate Flux MCP 服务器是一个实现了 Model Context Protocol (MCP) 的后端服务,旨在为 AI 助手提供高质量的图像和 SVG 矢量图形生成能力。它利用 Replicate API 接入 Black Forest Labs 的 Flux Schnell 模型(用于生成位图图像)和 Recraft 的 V3 SVG 模型(用于生成矢量图形)。通过此服务器,您的 AI 助手可以轻松调用图像和 SVG 生成工具,并管理生成历史记录。
主要功能点
- 高质量图像生成: 使用 Flux Schnell 模型根据文本提示生成高质量图像。
- SVG 矢量图形生成: 使用 Recraft V3 SVG 模型根据文本提示生成专业级 SVG 矢量图形。
- 多种图像生成模式: 支持单张图像生成、批量图像生成和图像变体生成,满足不同的创作需求。
- 可配置参数: 提供丰富的参数选项,如分辨率、宽高比、输出格式、风格等,允许用户精细控制生成结果。
- 历史记录管理: 提供资源浏览功能,方便用户查看和管理过往的图像和 SVG 生成记录。
- 通用 MCP 兼容性: 兼容所有 MCP 客户端,如 Cursor, Claude Desktop, Cline 和 Zed 等。
安装步骤
-
获取 Replicate API Token:
- 访问 Replicate 注册账号。
- 在账号设置中创建 API token 并妥善保管。
-
安装 Replicate Flux MCP 服务器:
- 确保您的环境中已安装 Node.js 和 npm。
- 打开终端,执行以下命令全局安装 'replicate-flux-mcp' 包:
npm install -g replicate-flux-mcp
服务器配置
MCP 服务器配置用于告知 MCP 客户端如何启动和连接服务器。以下是配置 'replicate-flux-mcp' 服务器的 'mcp.json' 示例,您需要根据您的 MCP 客户端进行配置:
{ "mcpServers": { "replicate-flux-mcp": { // 服务器名称,可以自定义 "command": "env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN npx", // 启动命令,指定环境变量 REPLICATE_API_TOKEN 和 npx 命令 "args": ["-y", "replicate-flux-mcp"] // 命令参数,指定运行 replicate-flux-mcp 包 } } }
配置参数说明:
- '"replicate-flux-mcp"': 服务器名称,客户端用此名称识别服务器。您可以自定义名称。
- '"command": "env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN npx"': 服务器启动命令。
- 'env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN': 设置环境变量 'REPLICATE_API_TOKEN',请将 'YOUR_REPLICATE_API_TOKEN' 替换为您在 Replicate 官网获取的 API Token。这是服务器连接 Replicate API 的凭证。
- 'npx': Node.js 包执行器,用于运行本地或全局安装的 npm 包。
- '"args": ["-y", "replicate-flux-mcp"]': 传递给 'npx' 的参数。
- '"-y"': 'npx' 参数,用于跳过安装包的确认提示。
- '"replicate-flux-mcp"': 指定要执行的 npm 包名称,即 'replicate-flux-mcp'。
重要提示:
- 请务必将 '"YOUR_REPLICATE_API_TOKEN"' 替换为您真实的 Replicate API Token。
- 不同的 MCP 客户端配置文件的位置和格式可能略有不同,请参考您使用的 MCP 客户端的官方文档进行配置。
- 如果您不希望全局安装,也可以在项目目录下安装 'replicate-flux-mcp' 并使用相对路径配置启动命令。
基本使用方法
配置完成后,在您的 MCP 客户端(如 Cursor, Claude Desktop 等)中,即可通过自然语言指令调用 Replicate Flux MCP 服务器的功能。
图像生成示例:
向您的 AI 助手发送类似如下指令:
- '请生成一张日落时分的宁静山景图'
- '画一幅未来城市夜景的图像'
- 'generate image of a cute cat wearing a hat' (英文指令)
SVG 矢量图形生成示例:
- '请生成一个简约风格的房子 SVG 图标'
- '创建一个科技感十足的电路板 SVG'
- 'generate svg icon of a shopping cart' (英文指令)
您还可以尝试更高级的功能,例如:
- 使用 'generate_multiple_images' 工具批量生成多张不同主题的图像。
- 使用 'generate_image_variants' 工具生成同一主题的不同风格或变体的图像。
- 使用 'imagelist' 和 'svglist' 资源浏览和查看历史生成记录。
具体工具和资源的使用方法,请参考仓库 README.md 文档中 "Documentation" 章节的详细说明。
信息
分类
AI与计算