El El San Vidu MCP Server

🚀 Vidu ビデオ生成 API のモデルコンテキストプロトコル（MCP）サーバー

このサーバーは、Vidu ビデオ生成 API とのやり取りに使用される 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 クライアントからの接続を受け入れる準備ができます。

高度な使用法

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": "背景に群山がある静かな湖",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

2. 生成状態の確認

ビデオ生成タスクの状態を確認します。

パラメータ：

• task_id（必須）：画像からビデオへの変換ツールが返すタスク ID

リクエスト例：

{
  "task_id": "12345"
}

3. 画像のアップロード

画像ファイルをサーバーにアップロードします。

パラメータ：

• image_file（必須）：アップロードする画像ファイル

🔧 技術詳細

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいて構築されており、Vidu の生成 AI モデルとやり取りするためのインターフェースを提供します。画像からのビデオ生成、生成進捗の監視、画像ファイルの管理などのタスクを処理します。

📚 ドキュメント

トラブルシューティング

• 問題 1：サーバーを起動できない場合

  • Node.js が正しくインストールされ、バージョンが要件を満たしていることを確認してください。
  • package.json ファイルが存在し、すべての依存関係が正しくインストールされていることを確認してください。

• 問題 2：ビデオを生成できない場合

  • Vidu API キーが .env ファイルに正しく設定されていることを確認してください。
  • ネットワーク接続を確認し、Vidu の API サービスにアクセスできることを確認してください。

貢献

コミュニティからの貢献を歓迎します！改善策や機能追加のアイデアがある場合は、プルリクエストを送信してください。