Stats
Links
Categories
Grok Imagine Video MCP Server
xAI の Grok Imagine Video API 用 MCP (Model Context Protocol) サーバー。テキストプロンプトからの動画生成、画像からの動画生成（Image-to-Video）、既存動画の編集をサポートします。
クイックスタート (npx)
最も簡単な方法は npx を使用することです：
# APIキーを設定
export XAI_API_KEY="xai-your-api-key"
# サーバーを実行
npx grok-imagine-video-mcp-server
機能
- 動画生成（Text-to-Video）: テキストプロンプトから新規動画を生成
- 動画生成（Image-to-Video）: 画像を入力として動画を生成
- 動画編集: 既存動画をプロンプトで編集
- バッチ処理: CLIで複数動画を一括処理
- 多様なアスペクト比をサポート（16:9, 4:3, 1:1, 9:16 など）
- 解像度: 720p, 480p
- 動画長: 1〜15秒（編集時は元動画と同じ長さ）
- 非同期処理対応（ポーリングによる結果取得）
サポートモデル
| モデル | 機能 | 備考 |
|---|---|---|
grok-imagine-video | 生成・編集 | 推奨・デフォルト |
必要条件
- Node.js 18.0.0 以上
- xAI API キー（console.x.ai から取得）
インストール
方法1: npx（推奨）
npx grok-imagine-video-mcp-server
方法2: グローバルインストール
npm install -g grok-imagine-video-mcp-server
grok-imagine-video-mcp-server
設定
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
XAI_API_KEY | Yes | xAI API キー |
DEBUG | No | true でデバッグログを有効化 |
OUTPUT_DIR | No | 動画のデフォルト出力ディレクトリ |
VIDEO_POLL_INTERVAL | No | ポーリング間隔（ミリ秒、デフォルト: 5000） |
VIDEO_MAX_POLL_ATTEMPTS | No | 最大ポーリング回数（デフォルト: 120） |
Claude Desktop 設定
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"grok-imagine-video": {
"command": "npx",
"args": ["-y", "grok-imagine-video-mcp-server"],
"env": {
"XAI_API_KEY": "xai-your-api-key-here"
}
}
}
}
ツール
generate_video
テキストプロンプトまたは画像から動画を生成します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
prompt | string | Yes | 生成する動画の説明テキスト |
output_path | string | No | 出力ファイルパス（デフォルト: generated_video.mp4） |
model | string | No | モデル（デフォルト: grok-imagine-video） |
duration | number | No | 動画長（1-15秒、デフォルト: 5） |
aspect_ratio | string | No | アスペクト比（デフォルト: 16:9） |
resolution | string | No | 解像度（720p/480p、デフォルト: 720p） |
image_url | string | No | Image-to-Video用の入力画像URL |
image_path | string | No | ローカル画像ファイルパス（base64 data URLとしてAPIに送信） |
注意:
image_urlとimage_pathは同時に指定できません。
edit_video
既存動画を編集します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
prompt | string | Yes | 編集内容の説明 |
video_url | string | Yes | 編集する動画のURL（公開アクセス可能、最大8.7秒） |
output_path | string | No | 出力ファイルパス（デフォルト: edited_video.mp4） |
model | string | No | モデル（デフォルト: grok-imagine-video） |
注意: 編集後の動画は元動画と同じ長さになります。
durationパラメータは編集時には指定できません。
バッチ処理 CLI
コマンド書式
grok-imagine-video-batch <config.json> [options]
または npx 経由：
npx grok-imagine-video-batch <config.json> [options]
基本的な使用例
# 設定ファイルでバッチ実行
npx grok-imagine-video-batch batch.json
# コスト見積もりのみ（実行しない）
npx grok-imagine-video-batch batch.json --estimate-only
# 出力先とフォーマットを指定
npx grok-imagine-video-batch batch.json --output-dir ./videos --format json
# ポーリング設定をカスタマイズ
npx grok-imagine-video-batch batch.json --poll-interval 10000 --max-poll-attempts 60
# 高並列実行（タイムアウト延長）
npx grok-imagine-video-batch batch.json --max-concurrent 5 --timeout 1800000
# ヘルプ表示
npx grok-imagine-video-batch --help
# バージョン表示
npx grok-imagine-video-batch --version
CLI オプション一覧
| オプション | 短縮形 | 引数 | 説明 | デフォルト |
|---|---|---|---|---|
--output-dir | - | <path> | 出力ディレクトリを上書き | 設定ファイルから |
--format | - | text|json | 出力フォーマット | text |
--timeout | - | <ms> | タイムアウト（ミリ秒、最小1000） | 600000 |
--max-concurrent | - | <n> | 最大同時実行数（1-10） | 2 |
--poll-interval | - | <ms> | ポーリング間隔（ミリ秒、最小1000） | 5000 |
--max-poll-attempts | - | <n> | 最大ポーリング回数 | 120 |
--estimate-only | - | - | コスト見積もりのみ（実行しない） | - |
--allow-any-path | - | - | 任意の出力パスを許可（CI/CD用） | - |
--help | -h | - | ヘルプメッセージ表示 | - |
--version | -v | - | バージョン表示 | - |
終了コード
| コード | 意味 |
|---|---|
0 | 成功（全ジョブ完了） |
1 | エラー（失敗またはキャンセルあり） |