Vidu MCP Server

🚀 Vidu ビデオ生成 MCP サーバー

Vidu ビデオ生成 MCP サーバーは、Vidu ビデオ生成 API と接続するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用することで、Vidu の強力な AI モデルを介して画像からビデオを生成することができます。

🚀 クイックスタート

Vidu ビデオ生成 MCP サーバーは、Vidu ビデオ生成 API と連携し、画像からビデオを生成するためのサーバーです。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• 画像からビデオへの変換：静的画像からビデオを生成し、カスタム設定をサポートします。
• 生成状態の確認：ビデオ生成タスクの進行状況を監視します。
• 画像のアップロード：Vidu API で使用する画像を簡単にアップロードします。

📦 インストール

前提条件

• Node.js（v14 以上）
• Vidu API キー（Vidu ウェブサイト から取得可能）
• TypeScript（開発用）

Smithery を通じたインストール

Smithery を通じて、Claude デスクトップ用に Vidu ビデオ生成サーバーを自動インストールするには、次のコマンドを実行します。

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. 画像のアップロード

後続の処理のために 1 つまたは複数の画像をアップロードします。 パラメータ：

• 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 パラメータを調整して、最適な組み合わせを見つけてください。

🔧 技術詳細

Vidu ビデオ生成 MCP サーバーは、モデルコンテキストプロトコル（MCP）を使用して Vidu のビデオ生成 API と通信します。サーバーはクライアントからのリクエストを受け取り、画像とプロンプト情報を処理し、Vidu API を呼び出してビデオを生成します。生成されたビデオはクラウドに保存され、ユーザーは API を通じてダウンロードリンクを取得できます。

貢献

コミュニティからのコードの貢献や改善提案を歓迎します！プロジェクト開発に参加するには、Pull Request を提出してください。