VEO 3.1

VEO 3.1 MCP サーバー

非同期ジョブパターン、API キーのローテーション、複数のフォールバックダウンロードに対応した、Google VEO 3.1 動画生成向けのプロフェッショナルグレード MCP サーバーです。

クイックインストール

pip install veo-mcp-server
# or
uvx veo-mcp-server --help

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "veo": {
      "command": "uvx",
      "args": ["veo-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

変数	説明	デフォルト
GEMINI_API_KEY	Gemini API キー — すべての生成で必須です	--
GEMINI_API_KEY_BACKUP	429 発生時の自動ローテーション用バックアップキー	--
VIDEO_OUTPUT_DIR	生成した動画の保存先ディレクトリ	~/veo-videos

できること

Google の VEO 3.1 モデルを使用して AI 動画を生成します。テキストからの動画生成、画像からの動画生成、動画の延長、フレーム補間に対応しています。生成をバックグラウンドですぐに開始し、ポーリング用のジョブ ID を返す非同期ジョブパターンを使用します。

ツール（9）

ツール	説明
veo_generate_video	テキストプロンプトから動画を生成します。解像度（720p／1080p／4K）、アスペクト比（16:9／9:16）、長さ（4／6／8 秒）、ネガティブプロンプト、参照画像、シード制御、バッチ生成（動画 1～4 本）に対応しています。
veo_image_to_video	テキストプロンプトを使用して参照画像をアニメーション化します。解像度、アスペクト比、参照画像、シード制御に対応しています。
veo_interpolate_video	最初のフレームと最後のフレームの画像の間に、滑らかな動画トランジションを作成します。
veo_extend_video	既存の VEO 生成動画を約 7 秒延長します。720p のみ対応し、合計の長さは最大 148 秒です。ソースは以前に VEO で生成された動画である必要があります（生成元はサーバー側で追跡されます）。
veo_check_job	非同期動画生成ジョブのステータスを確認します。ステータスが「completed」または「failed」になるまで繰り返し呼び出してください。
veo_list_jobs	すべての動画生成ジョブと現在のステータスを一覧表示します。
veo_api_status	現在の API キーローテーションのステータス（設定済みのキー、アクティブなキー、残りのキー）を表示します。
veo_pricing_info	すべての解像度について、標準モデルと高速モデルそれぞれの、生成動画 1 秒あたりの VEO 3.1 の料金を表示します。
veo_show_output_stats	生成した動画と、実行中／最近のジョブに関する統計情報を表示します。

設定

変数	説明	デフォルト
GEMINI_API_KEY	Gemini API のプライマリーキー（必須）	--
GEMINI_API_KEY_BACKUP	429 発生時の自動ローテーション用バックアップキー	--
VIDEO_OUTPUT_DIR	生成した動画の保存先ディレクトリ	~/veo-videos

アーキテクチャ

• 非同期ジョブパターン：すべての生成ツールはジョブ ID を即座に返します。バックグラウンドスレッドが時間のかかる Google API 呼び出しを処理するため、各 MCP 呼び出しは 5 秒以内に返ります。
• API キーのローテーション：429／RESOURCE_EXHAUSTED の発生時に、バックアップキーへ自動的に切り替えて再試行します。
• 3 層のダウンロードフォールバック：SDK ダウンロード → URI フォールバック → ACTIVE 状態になるまで待機します。Google の Files API におけるエッジケースに対応します。
• 予防的クリーンアップ：連鎖的な 500 エラーを防ぐため、各生成の前に処理が停止した PROCESSING ファイルを削除します。

モデル

ティア	モデル ID	用途
標準	veo-3.1-generate-preview	より高品質な出力
高速	veo-3.1-fast-generate-preview	より高速な生成

ライセンス

MIT