项目介绍
复制 Flux MCP
复制 Flux MCP 是一个高级的模型上下文协议（MCP）服务器，它使AI助手能够生成高质量的图像和矢量图形。利用通过Replicate API访问的Black Forest Labs的Flux Schnell模型生成光栅图像，以及Recraft的V3 SVG模型生成矢量图形。
📑 目录
🚀 开始与集成
设置过程
-
获取 Replicate API Token
- 在 Replicate 注册
- 在账户设置中创建一个 API Token
-
选择您的集成方法
- 根据您偏好的 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 Token - 重启 Cursor 以应用更改
方法 2：手动模式
- 打开 Cursor 并进入设置
- 导航到“MCP”或“模型上下文协议”部分
- 点击“添加服务器”或类似按钮
- 在相应字段中输入以下命令：
env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp
- 将
YOUR_TOKEN替换为您实际的 Replicate API Token - 保存设置并根据需要重启 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 Token - 重启 Claude Desktop 以应用更改
Smithery 集成
此 MCP 服务器作为托管服务在 Smithery 上提供，允许您无需设置自己的服务器即可使用。
- 访问 Smithery 并创建一个账户（如果您还没有的话）
- 导航至 Replicate Flux MCP 服务器页面
- 点击“添加到工作区”以将服务器添加到您的 Smithery 工作区
- 配置您的 MCP 客户端（如 Cursor、Claude Desktop 等）以使用您的 Smithery 工作区 URL
更多关于如何使用 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助手集成 - 无缝启用AI助手（如Claude）生成视觉内容
- 🎛️ 高级自定义 - 通过控制纵横比、质量、分辨率等进行精细调整
- 🔌 普遍的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-1_0，默认：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"
}
}
}
}
⚙️ 技术细节
技术栈
- 模型上下文协议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, // ms
};
🔍 故障排除
常见问题
认证错误
- 确保您的
REPLICATE_API_TOKEN在环境中正确设置 - 通过直接测试Replicate API来验证您的Token是否有效
安全过滤器触发
- 模型内置了一个安全过滤器，可能会阻止某些提示
- 尝试修改您的提示以避免潜在的问题内容
超时错误
- 对于较大的图像或繁忙的服务器，您可能需要增加配置中的
pollingAttempts或pollingInterval - 默认设置应适用于大多数用例
🤝 贡献
欢迎贡献！请按照以下步骤贡献：
- 分叉仓库
- 创建您的功能分支（
git checkout -b feature/amazing-feature） - 提交您的更改（
git commit -m 'Add some amazing feature'） - 推送到分支（
git push origin feature/amazing-feature） - 打开一个拉取请求
对于功能请求或错误报告，请创建一个GitHub问题。如果您喜欢这个项目，请考虑给仓库点赞！
📄 许可证
本项目采用MIT许可证 - 详情请参阅LICENSE文件。
🔗 资源
- 模型上下文协议文档
- Replicate API 文档
- Flux Schnell 模型
- Recraft V3 SVG 模型
- MCP TypeScript SDK
- Smithery 文档
- Glama.ai MCP 服务器
🎨 示例
| 多个提示 | 提示变体 |
|---|---|
这里是一些如何使用这些工具的例子：