grokvideo-generator

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	エラー（失敗またはキャンセルあり）

バッチ設定ファイル