Tongyi Wanx MCP Server

🚀 通義萬相 MCP 服務器

這是一個基於 TypeScript 的 Model Context Protocol (MCP) 服務器，專門提供阿里雲通義萬相的文生圖(Text-to-Image)和文生視頻(Text-to-Video)能力。該服務器藉助 MCP 協議，允許大語言模型（LLM）直接調用通義萬相的圖像和視頻生成 API。

🚀 快速開始

以百鍊平臺為例，展示如何使用該服務器：

{
  "mcpServers": {
    "tongyi-wanxiang": {
      "command": "npx",
      "args": [
        "-y",
        "tongyi-wanx-mcp-server@latest"
      ],
      "env": {
        "DASHSCOPE_API_KEY": "<你的通義萬相 API 訪問密鑰>"
      }
    }
  }
}

✨ 主要特性

• 文生圖能力集成：接入阿里雲通義萬相文生圖 API，支持高質量的 AI 圖像生成。
• 文生視頻能力集成：接入阿里雲通義萬相文生視頻 API，支持高質量的 AI 視頻生成。
• 異步任務處理：支持長時間運行的圖像和視頻生成任務，通過異步輪詢獲取最終結果。
• MCP 協議支持：符合 Model Context Protocol 規範，可與支持 MCP 的 LLM 無縫協作。

📦 安裝指南

安裝依賴

npm install

構建項目

npm run build

啟動服務器

npm start

💻 使用示例

基礎用法

以百鍊平臺為例，配置服務器的使用示例：

{
  "mcpServers": {
    "tongyi-wanxiang": {
      "command": "npx",
      "args": [
        "-y",
        "tongyi-wanx-mcp-server@latest"
      ],
      "env": {
        "DASHSCOPE_API_KEY": "<你的通義萬相 API 訪問密鑰>"
      }
    }
  }
}

📚 詳細文檔

API 接口說明

文生圖生成接口

• 參數：
  • prompt：圖像描述的文本。
  • width：圖像寬度，默認為 512。
  • height：圖像高度，默認為 512。
  • negative_prompt（可選）：減少生成圖像中出現的內容。
• 返回值：

{
  "task_id": string // 任務唯一標識符
}

文生圖結果獲取接口

• 參數：
  • task_id：文生圖生成時返回的任務 ID。
• 返回值：

{
  "status": "completed" || "processing" || "failed",
  "result_url": string, // 圖像 URL，僅在完成時返回
  "error_message": string // 錯誤信息，失敗時返回
}

文生視頻生成接口

• 參數：
  • prompt：視頻描述的文本。
  • width：視頻寬度，默認為 512。
  • height：視頻高度，默認為 512。
  • duration（可選）：視頻時長，默認為 10 秒。
  • negative_prompt（可選）：減少生成視頻中出現的內容。
• 返回值：

{
  "task_id": string // 任務唯一標識符
}

文生視頻結果獲取接口

• 參數：
  • task_id：文生視頻生成時返回的任務 ID。
• 返回值：

{
  "status": "completed" || "processing" || "failed",
  "result_url": string, // 視頻 URL，僅在完成時返回
  "error_message": string // 錯誤信息，失敗時返回
}

配置文件

// config.ts
export const CONFIG = {
  // 圖像生成相關配置
  IMAGE_GENERATION: {
    pollingInterval: 1000, // 輪詢間隔時間，默認為 1 秒
    maxRetries: 5,         // 最大重試次數，默認為 5 次
    timeout: 30000         // 任務超時時間，默認為 30 秒
  },

  // 視頻生成相關配置
  VIDEO_GENERATION: {
    pollingInterval: 2000, // 輪詢間隔時間，默認為 2 秒
    maxRetries: 10,       // 最大重試次數，默認為 10 次
    timeout: 600000        // 任務超時時間，默認為 10 分鐘
  }
};

🔧 技術細節

環境要求

• Node.js >= 16.x
• npm >= 8.x 或 pnpm

注意事項

⚠️ 重要提示

• 請確保您擁有有效的通義萬相 API 訪問密鑰，並妥善保管。
• 圖像生成可能需要數秒到數十秒不等，視頻生成耗時更長，需耐心等待。
• 服務器端的輪詢間隔和重試次數應根據具體場景進行合理設置，避免資源浪費。
• 對於失敗的任務，請檢查 error_message 以獲取更多信息，並採取相應措施。

📄 參考資料

• 通義萬相 API 文檔
• Model Context Protocol (MCP) 規範