Vidu MCP Server

🚀 Vidu 視頻生成 MCP 服務器

Vidu 視頻生成 MCP 服務器是一個與 Vidu 視頻生成 API 對接的模型上下文協議（MCP）服務器。它提供了一系列工具，能借助 Vidu 強大的 AI 模型，輕鬆地從圖片生成視頻。

🚀 快速開始

Vidu 視頻生成 MCP 服務器可幫助你利用 Vidu 的 AI 模型將圖片轉化為視頻。下面為你介紹使用該服務器的基本步驟。

✨ 主要特性

• 圖片轉視頻：支持從靜態圖片生成視頻，並且可進行自定義設置。
• 檢查生成狀態：能夠監控視頻生成任務的進度。
• 上傳圖片：可輕鬆上傳圖片供 Vidu API 使用。

📦 安裝指南

先決條件

• Node.js（v14 或更高版本）
• Vidu API 密鑰（可從 Vidu 網站 獲取）
• TypeScript（用於開發）

通過 Smithery 安裝

若要自動通過 Smithery 安裝 Vidu 視頻生成服務器以供 Claude 桌面使用，可執行以下命令：

npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude

手動安裝

1. 克隆此倉庫：

git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server

2. 安裝依賴項：

npm install

3. 基於 .env.template 創建一個 .env 文件，並添加你的 Vidu API 密鑰：

VIDU_API_KEY=your_api_key_here

💻 使用示例

基礎用法

啟動服務器

1. 構建 TypeScript 代碼：

npm run build

2. 啟動服務器：

npm start

啟動後，MCP 服務器將準備好接受來自 MCP 客戶端的連接。

高級用法

1. 圖片轉視頻

將靜態圖片轉換為視頻，支持自定義參數。 參數：

• image_url（必填）：要轉換為視頻的圖片 URL
• prompt（可選）：視頻生成的文字提示（最多 1500 字符）
• duration（可選）：輸出視頻時長（4 或 8 秒，默認 4 秒）
• model（可選）：生成模型名稱（"vidu1.0"、"vidu1.5"、"vidu2.0"，默認 "vidu2.0"）
• resolution（可選）：輸出視頻分辨率（"360p"、"720p"、"1080p"，默認 "720p"）
• movement_amplitude（可選）：幀中物體運動幅度（"low"、"medium"、"high"，默認 "medium"）
• fps（可選）：視頻幀率（15 或 30，默認 30）

示例請求：

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "未來城市夜景",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "1080p",
  "movement_amplitude": "high",
  "fps": 30
}

2. 檢查生成狀態

監控視頻生成任務的當前狀態。 參數：

• task_id（必填）：要檢查的任務 ID

示例請求：

{
  "task_id": "12345678-9abc-1234-5678-1234567890ab"
}

3. 上傳圖片

上傳一張或多張圖片以供後續處理。 參數：

• images（必填）：要上傳的圖片列表，支持 URL 或本地文件路徑
• prompt（可選）：描述圖片內容的文字提示

示例請求：

{
  "images": ["https://example.com/image1.jpg", "/local/path/image2.png"],
  "prompt": "風景照片"
}

🔧 技術細節

Vidu 視頻生成 MCP 服務器通過模型上下文協議（MCP）與 Vidu 的視頻生成 API 進行交互。該服務器接收客戶端請求，處理圖片和提示信息，並調用 Vidu API 生成相應視頻內容。生成的視頻文件存儲在雲端，用戶可通過 API 獲取下載鏈接。

📚 詳細文檔

故障排除

1. 無法啟動服務器：確保 Node.js 版本符合要求（v14 或更高），並且所有依賴項已正確安裝。
2. API 請求失敗：檢查網絡連接，確認 Vidu API 密鑰有效，並查看具體錯誤信息以解決問題。
3. 生成視頻質量低：嘗試調整 model、resolution 和 movement_amplitude 參數，找到最佳組合。

貢獻

歡迎社區貢獻代碼或提出改進意見！請通過提交 Pull Request 的方式參與項目開發。