Image Generation (Flux Schnell)

🚀 圖像生成 MCP 服務器

本項目是一個 MCP (Model Context Protocol) 服務器實現，可藉助 Replicate 的 black-forest-labs/flux-schnell 模型生成圖像。它既適合與 Cursor 的 MCP 功能搭配使用，也能和其他 MCP 客戶端兼容。

🚀 快速開始

先決條件

• Node.js 16+
• Replicate API 令牌
• TypeScript 的 MCP SDK

設置

1. 克隆倉庫。

2. 安裝依賴：

   npm install
   

3. 將你的 Replicate API 令牌直接在 src/imageService.ts 中更新 apiToken 常量：

   // 在這裡直接添加您的 API 令牌，因為環境變量在 Cursor 中不易設置
   const apiToken = "your-replicate-api-token-here";
   

   ⚠️ 重要提示

   如果使用 Claude，請在根目錄創建一個 .env 文件，並將 API 令牌設置為：

   REPLICATE_API_TOKEN=your-replicate-api-token-here
   

   然後構建項目：

   npm run build
   

使用說明

與 Cursor 一起使用時：

1. 轉到設置。
2. 選擇功能。
3. 滾動到底部的 "MCP 服務器"。
4. 點擊 "添加新的 MCP 服務器"。
5. 設置類型為 "Command"。
6. 設置命令為：node ./path/to/dist/server.js。

✨ 主要特性

• 從文本提示生成圖像。
• 可配置的圖像參數（分辨率、寬高比、質量）。
• 將生成的圖像保存到指定目錄。
• 完全符合 MCP 協議。
• 錯誤處理和驗證。

📚 詳細文檔

API 參數

示例請求

{
  "prompt": "黑色森林蛋糕，上面寫著 'FLUX SCHNELL'",
  "output_dir": "/var/output/images",
  "filename": "black_forest_cake",
  "output_format": "webp",
  "go_fast": true,
  "megapixels": "1",
  "num_outputs": 2,
  "aspect_ratio": "1:1"
}

示例響應

{
  "status": "success",
  "message": "圖像已生成並保存到指定目錄。",
  "data": {
    "filename": "black_forest_cake.png",
    "size": "2.5 MB",
    "dimensions": "1920x1080"
  }
}

錯誤處理

• 輸入錯誤：如果提示或參數無效，將返回驗證錯誤。
• API 錯誤：如果調用 Replicate API 失敗，將返回相關錯誤信息。
• 保存錯誤：如果無法將圖像保存到指定目錄，將返回存儲錯誤。

📄 許可證

該代碼受 MIT License 保護。