El El San Vidu MCP Server

🚀 Vidu 視頻生成 API 的模型上下文協議（MCP）服務器

Vidu 視頻生成 API 的模型上下文協議（MCP）服務器是一個強大的工具，用於與 Vidu 視頻生成 API 交互，可實現從圖像生成視頻的功能。

🚀 快速開始

Vidu MCP 服務器能助力你輕鬆實現圖像到視頻的轉換。你只需按照以下步驟操作，就能啟動服務器並使用其功能。

✨ 主要特性

• 圖像轉視頻：藉助 Vidu 的人工智能模型，可將靜態圖像轉化為視頻。
• 檢查生成狀態：即時監控視頻生成任務的進度。
• 上傳圖像：方便快捷地上傳圖像，供 Vidu API 使用。

📦 安裝指南

先決條件

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

安裝步驟

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 客戶端的連接。

工具使用

基礎用法

圖像轉視頻

將靜態圖像轉換為視頻，帶有可自定義的參數。

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "一個寧靜的湖與背景中的群山",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

參數說明：

檢查生成狀態

檢查視頻生成任務的狀態。

{
  "task_id": "12345"
}

參數說明：

上傳圖像

將圖像文件上傳到服務器。

{
  "image_file": "your_image_file"
}

參數說明：

📚 詳細文檔

工作原理

該服務器基於模型上下文協議（MCP）構建，提供了一個接口用於與 Vidu 的生成式 AI 模型交互。它處理的任務包括從圖像生成視頻、監控生成進度以及管理圖像文件。

故障排除

• 問題 1：無法啟動服務器
  • 確保 Node.js 已正確安裝且版本符合要求。
  • 檢查 package.json 文件是否存在，並確保所有依賴項已正確安裝。
• 問題 2：無法生成視頻
  • 確保 Vidu API 密鑰已正確設置在 .env 文件中。
  • 檢查網絡連接，確保能夠訪問 Vidu 的 API 服務。

🤝 貢獻

我們歡迎社區的貢獻！如果您有任何改進或功能添加的想法，請提交拉取請求。