vidu-mcp-server
If you are the rightful owner of vidu-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for interacting with the Vidu video generation API, providing tools for generating videos from images using Vidu's AI models.
Vidu MCP Server
Vidu動画生成APIと連携するためのModel Context Protocol (MCP) サーバーです。Viduの強力なAIモデルを使用して、画像から動画を生成するツールを提供します。
機能
- 画像から動画への変換: カスタマイズ可能な設定で静止画から動画を生成
- 複数モデル対応: viduq1、vidu1.5、vidu2.0
- モデル固有の時間・解像度制約
- 4秒動画向けのBGM対応
- 非同期通知用のコールバックURL対応
- 生成状況の確認: クレジット使用量情報付きで動画生成タスクの進捗を監視
- 画像アップロード: Vidu APIで使用する画像を簡単にアップロード（最大10MB）
前提条件
- Node.js (v14以上)
- Vidu APIキー（Viduウェブサイトから取得可能）
- TypeScript（開発用）
インストール
Smithery経由でのインストール
Smitheryを使用してClaude Desktop用のVidu Video Generation Serverを自動インストール:
npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude
Gemini CLI設定
Gemini CLIで使用するには、~/.gemini/settings.jsonにサーバー設定を追加してください:
{
"mcpServers": {
"vidu": {
"command": "node",
"args": [
"your_path/vidu-mcp-server/build/index.js"
],
"env": {
"VIDU_API_KEY": "your_api_key_here"
}
}
}
}
注意: your_pathを実際のインストールディレクトリのパスに、your_api_key_hereをあなたのVidu APIキーに置き換えてください。
手動インストール
- このリポジトリをクローン:
git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server
- 依存関係をインストール:
npm install
.env.templateを基に.envファイルを作成し、Vidu APIキーを追加:
VIDU_API_KEY=your_api_key_here
使用方法
Gemini CLI用
- TypeScriptコードをビルド:
npm run build
-
Gemini CLI設定で設定（上記のGemini CLI設定セクションを参照）
-
Gemini CLIを再起動してMCPを読み込み
ツール
1. 画像から動画への変換
カスタマイズ可能なパラメータで静止画を動画に変換します。
パラメータ:
image_url(必須): 動画に変換する画像のURLprompt(オプション): 動画生成用のテキストプロンプト（最大1500文字）duration(オプション): 出力動画の時間（秒）（モデル固有）- viduq1: 5秒のみ
- vidu1.5/vidu2.0: 4秒または8秒（デフォルト4秒）
model(オプション): 生成用モデル名（"viduq1", "vidu1.5", "vidu2.0", デフォルト "vidu2.0"）resolution(オプション): 出力動画の解像度（モデル/時間固有）- viduq1 (5s): 1080pのみ
- vidu1.5/vidu2.0 (4s): "360p", "720p", "1080p"（デフォルト "360p"）
- vidu1.5/vidu2.0 (8s): "720p"のみ
movement_amplitude(オプション): フレーム内オブジェクトの動きの振幅（"auto", "small", "medium", "large", デフォルト "auto"）seed(オプション): 再現性のためのランダムシードbgm(オプション): 動画にBGMを追加（boolean, デフォルト false, 4秒動画のみ）callback_url(オプション): 生成状況変更時の非同期通知用URL
リクエスト例:
{
"image_url": "https://example.com/image.jpg",
"prompt": "山を背景にした静かな湖",
"duration": 8,
"model": "vidu2.0",
"resolution": "720p",
"movement_amplitude": "medium",
"seed": 12345,
"bgm": false
}
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"
}
トラブルシューティング
- APIキーの問題: Vidu APIキーが
.envファイル（手動設定の場合）またはGemini CLI設定（Gemini CLI設定の場合）で正しく設定されていることを確認してください - ファイルアップロードエラー: 画像ファイルが有効で、サイズ制限内（upload-imageツールは10MB、直接URL画像は最大50MB）であることを確認してください
- 接続問題: インターネットアクセスがあり、Vidu APIサーバーに到達できることを確認してください
- Gemini CLIの問題:
- Gemini CLIで設定する前にサーバーがビルドされている（
npm run build）ことを確認してください - settings.jsonのパスが正しい
build/index.jsファイルを指していることを確認してください - 設定変更後にGemini CLIを再起動してください
- サーバー設定で
"disabled": falseに設定してください
- Gemini CLIで設定する前にサーバーがビルドされている（
