Vidu MCP Server

Vidu MCP サーバー

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

特徴

• 画像から動画への変換: カスタマイズ可能な設定で静止画像から動画を生成します
• 生成ステータスの確認: ビデオ生成タスクの進行状況を監視する
• 画像アップロード: Vidu APIで使用する画像を簡単にアップロードできます

前提条件

• Node.js (v14以上)
• Vidu API キー ( Vidu Web サイトから入手可能)
• TypeScript（開発用）

インストール

Smithery経由でインストール

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

手動インストール

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

3. .env.templateに基づいて.envファイルを作成し、Vidu API キーを追加します。

使用法

1. TypeScript コードをビルドします。

2. サーバーを起動します。

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 （オプション）：再現性のためのランダムシード

リクエストの例:

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

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

パラメータ:

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

リクエストの例:

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

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

パラメータ:

• image_path (必須): 画像ファイルへのローカルパス
• image_type (必須): 画像ファイルの種類 ("png", "webp", "jpeg", "jpg")

リクエストの例:

仕組み

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

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

• APIキーによる認証
• ファイルのアップロードとフォーマットの検証
• 非同期タスク管理とポーリング
• エラー処理とレポート

トラブルシューティング

• APIキーの問題: Vidu APIキーが.envファイルに正しく設定されていることを確認してください
• ファイルアップロードエラー: 画像ファイルが有効であり、サイズが10MB未満であることを確認してください
• 接続の問題: インターネットにアクセスでき、Vidu API サーバーにアクセスできることを確認してください。

貢献

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