Ali Flux MCP

🚀 阿里雲DashScope API的Model Context Protocol（MCP）服務器

這是一個基於TypeScript的MCP服務器，可與阿里雲DashScope API進行交互，實現圖像生成與本地保存功能。該服務器對核心MCP概念進行了演示，具備以下實用工具：

• 藉助阿里雲DashScope API生成圖像。
• 檢查圖像生成任務的狀態。
• 下載生成的圖像並保存至本地磁盤。

🚀 快速開始

此服務器是基於TypeScript構建的MCP服務器，用於和阿里雲DashScope API交互，實現圖像生成和本地保存功能。它能幫助你利用阿里雲DashScope API完成圖像生成任務，並將生成的圖像保存到本地。

✨ 主要特性

工具

• generate_image：使用阿里雲DashScope API生成圖像。
  • 必填參數：提示詞（prompt）。
  • 可選參數：大小（size）、隨機種子（seed）、步驟（steps）。
  • 功能：提交圖像生成任務到DashScope API。
• check_task_status：檢查圖像生成任務的狀態。
  • 必填參數：任務ID（task_id）。
  • 功能：返回當前圖像生成任務的狀態。
• download_image：下載生成的圖像並保存到本地磁盤。
  • 必填參數：任務ID（task_id）。
  • 可選參數：自定義保存路徑（save_path，必須是絕對路徑）。
  • 可選參數：用於解析相對路徑的基礎目錄（base_dir，默認為WORK_DIR環境變量）。
  • 功能：將所有生成的圖像下載並保存到指定目錄。

📦 安裝指南

開發準備

先決條件

• Node.js 和 npm。
• 阿里雲DashScope API密鑰。

環境變量

• DASHSCOPE_API_KEY：您的阿里雲DashScope API密鑰。
• SAVE_DIR：保存生成圖像的目錄（默認：~/Desktop/flux-images）。
• MODEL_NAME：DashScope模型名稱（默認：flux-merged）。
• WORK_DIR：工作目錄（默認：process.cwd()）。

項目搭建

• 安裝依賴：

npm install

• 構建服務器：

npm run build

• 開發時自動重建：

npm run watch

安裝配置

配置說明

要在Claude Desktop或其他兼容MCP的客戶端上使用，請在相應配置文件中添加此服務器：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json。
• Windows：%APPDATA%/Claude/claude_desktop_config.json。

{
  "mcpServers": {
    "ali-flux": {
      "command": "/path/to/ali-flux/build/index.js",
      "env": {
        "DASHSCOPE_API_KEY": "your-api-key-here",
        "SAVE_DIR": "/custom/save/path" // 可選
      }
    }
  }
}

調試

由於MCP服務器通過stdio通信，調試可能具有挑戰性。我們推薦使用MCP Inspector，它作為一個包腳本提供：

npm run inspector

Inspector將提供一個URL，用於在瀏覽器中訪問調試工具。