Replicate Flux MCP

🚀 MCP 服務器：Replicate - 基於模型上下文協議的圖像生成服務器

這是一個基於模型上下文協議（MCP）構建的AI圖像生成服務器，支持使用Replicate平臺上的先進AI模型進行圖像生成。它能夠解決用戶批量、多樣化圖像生成的需求，為圖像創作提供高效、便捷的服務。

🚀 快速開始

本服務器是基於模型上下文協議（MCP）構建的AI圖像生成服務器，可藉助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文件。