replicate-flux-mcp

🚀 MCP 服务器：Replicate - 基于模型上下文协议的图像生成服务器

这是一个基于模型上下文协议（MCP）构建的AI图像生成服务器，支持使用Replicate平台上的先进AI模型进行图像生成，可实现多图生批、多提示模式、图像变体生成及SVG图像生成等功能。

🚀 快速开始

此服务器基于模型上下文协议（MCP），借助Replicate平台上的AI模型进行图像生成。马上来体验强大的图像生成能力吧！

✨ 主要特性

1. 多图生批 (generate_multiple_images)

可以一次性根据多个不同提示生成多张图片。

{
  "prompts": [
    "A serene mountain lake at sunset", 
    "A bustling city street at night", 
    "A peaceful garden in spring"
  ]
}

2. 多提示模式

支持同时处理多个图像生成请求，每个请求可以指定不同的参数。

{
  "requests": [
    {
      "modelId": "black-forest-labs/flux-schnell",
      "prompt": "A futuristic city skyline at night",
      "width": 1024,
      "height": 512
    },
    {
      "modelId": "recraft-ai/recraft-v3-svg", 
      "prompt": "A character portrait in anime style", 
      "style": "anime"
    }
  ]
}

3. 图像变体生批 (generate_image_variants)

可以根据指定的提示生成多个不同变体。

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

4. SVG图像支持

通过Recraft V3 SVG模型提供高质量SVG图像生成能力。

🔧 技术细节

技术栈

• 模型上下文协议（MCP）SDK - 提供基础的服务器功能，如工具和资源管理
• Replicate API - 实现AI模型调用接口
• TypeScript - 保证代码类型安全
• Zod - 进行严格的运行时数据验证

配置参数

通过修改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
};

📚 详细文档

典型应用场景

| 多提示示例 | 提示变体示例 | |------------|-------------| | | |

示例用法

基础用法

批量生成多图

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

生成图像变体

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

故障排除

常见问题及解决方案：

1. 网络连接问题：请检查互联网访问权限，确保服务器可以访问Replicate API。
2. 模型加载失败：确认模型ID正确无误，并且在Replicate平台上有可用的版本。
3. 生成超时：增加pollingInterval值或优化网络环境。

🤝 贡献指南

欢迎任何贡献！请通过GitHub仓库提交问题和Pull Request。建议先阅读项目文档和代码规范，确保您的贡献符合项目要求。

🌐 资源链接

• 官方文档：模型上下文协议（MCP）
• Replicate平台：Replicate AI Models
• 开源仓库：GitHub Repository

📄 许可证

本项目遵循MIT许可证，详细内容请见LICENSE文件。