Vidu MCP サーバー

Vidu動画生成APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、Viduの強力なAIモデルを用いて画像から動画を生成するためのツールを提供します。

特徴

• 画像から動画への変換: カスタマイズ可能な設定で静止画像から動画を生成します

• 生成ステータスの確認: ビデオ生成タスクの進行状況を監視する

• 画像アップロード: Vidu APIで使用する画像を簡単にアップロードできます

Related MCP server: Ghibli Video MCP Server

前提条件

• Node.js (v14以上)

• Vidu API キー ( Vidu Web サイトから入手可能)

• TypeScript（開発用）

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Vidu Video Generation Server を自動的にインストールするには:

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 (オプション): フレーム内のオブジェクトの移動振幅 ("auto", "small", "medium", "large"、デフォルトは "auto")

• seed （オプション）：再現性のためのランダムシード

リクエストの例:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "A serene lake with mountains in the background",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

2. 生成ステータスを確認する

実行中のビデオ生成タスクのステータスを確認します。

パラメータ:

• task_id (必須): 画像から動画へのツールによって返されるタスクID

リクエストの例:

{
  "task_id": "12345abcde"
}

3. 画像をアップロードする

Vidu API で使用する画像をアップロードします。

パラメータ:

• image_path (必須): 画像ファイルへのローカルパス

• image_type (必須): 画像ファイルの種類 ("png", "webp", "jpeg", "jpg")

リクエストの例:

{
  "image_path": "/path/to/your/image.jpg",
  "image_type": "jpg"
}

仕組み

サーバーは、モデルコンテキストプロトコル（MCP）を使用して、AIツール向けの標準化されたインターフェースを提供します。サーバーを起動すると、標準入出力チャネルを介してコマンドをリッスンし、構造化された形式で結果を返します。

サーバーは、次のような Vidu API とのやり取りの複雑な部分をすべて処理します。

• APIキーによる認証

• ファイルのアップロードとフォーマットの検証

• 非同期タスク管理とポーリング

• エラー処理とレポート

トラブルシューティング

• APIキーの問題: Vidu APIキーが.envファイルに正しく設定されていることを確認してください

• ファイルアップロードエラー: 画像ファイルが有効であり、サイズが10MB未満であることを確認してください

• 接続の問題: インターネットにアクセスでき、Vidu API サーバーにアクセスできることを確認してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。