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

项目简介

这是一个基于模型上下文协议（MCP）构建的AI图像生成服务器，支持使用Replicate平台上的先进AI模型进行图像生成。当前实现包括：

• 使用Flux Schnell模型进行多图生批
• 多提示模式支持
• 图像变体生成功能
• SVG图像生成接口

核心特性

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文件。