genrelay-mcp

genrelay-mcp

GenRelay 用の MCP サーバーです。Claude Desktop、Cursor、または任意の MCP クライアントから動画や画像を生成できます。

1 つのサーバーで複数のモデルを利用できます：Veo 3.1、Grok Imagine、Omni Flash、Nano Banana Pro/2、GPT Image 2。

インストール

インストールは不要です。npx を使って MCP クライアントから接続してください。

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "genrelay": {
      "command": "npx",
      "args": ["-y", "genrelay-mcp"],
      "env": { "GENRELAY_API_KEY": "sk-..." }
    }
  }
}

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "genrelay": {
      "command": "npx",
      "args": ["-y", "genrelay-mcp"],
      "env": { "GENRELAY_API_KEY": "sk-..." }
    }
  }
}

genrelay.ai でキーを取得してください。設定を編集した後は、クライアントを再起動してください。

ツール

ツール	機能
generate_video	テキストから動画、または画像から動画を生成します。クリップを返します。処理中の場合はタスク ID を返します
generate_image	画像を生成・編集します。画像をインラインで返します
check_job	タスク ID を指定してジョブの状態を確認します
list_models	利用可能なモデルと、それぞれの用途を表示します

次のように依頼するだけです：

夜の雨の街を走るネオン色のキツネの 8 秒間の動画を、1080p で生成してください

待ち時間について

動画の生成には1～5 分かかり、MCP ツールの実行が許可されている時間を超える場合があります。そのため、generate_video は安全に待機できる時間まで待ってから、タスク ID を返します：

Still generating — this is normal for video.

task id: task_abc123
status: in_progress
progress: 35%

Call check_job with task id "task_abc123" in a minute or two.

これは通常の結果であり、失敗ではありません。ジョブはサーバー側で実行を続けます。再送信せず、check_job を使用してください（再送信すると、もう一度請求されます）。

画像は通常、制限時間内に生成が完了し、インラインで返されます。

モデル

動画

モデル	備考
veo_3_1	Google Veo 3.1 — 最高品質、音声対応
veo_3_1-fl	最初／最後のフレーム — 両方の端点を指定
veo_3_1-components	コンポーネントガイド対応
grok-imagine-video-1-5-preview	xAI Grok Imagine 1.5
grok-imagine-1-0-video	xAI Grok Imagine 1.0
omni-flash	高速で、長めのクリップに適しています
omni_flash_abra_edit	元動画から動画を編集

画像 — nano-banana-pro、nano-banana-2、gpt-image-2

ティア：画像は 1k／2k／4k、Veo 動画は 720p／1080p／4k です。料金はティアごとに設定されており、どのティアにも一致しない size を指定すると、モデルの基本料金が適用されます。費用を考慮する場合は、tier を明示的に設定してください。

設定

変数
GENRELAY_API_KEY	必須
GENRELAY_BASE_URL	任意。既定値は https://genrelay.ai/v1

その他の利用方法

• Python SDK — pip install genrelay
• JavaScript/TypeScript SDK — npm install genrelay
• チャットと画像編集は OpenAI 互換です。公式の openai パッケージで https://genrelay.ai/v1 を指定してください

開発

npm install
npm run build
node test/smoke.mjs   # boots the server and speaks MCP to it

よくある質問

genrelay-mcp とは何ですか？ Claude Desktop、Cursor、その他の MCP クライアントから GenRelay API を通じて動画や画像を生成できる MCP サーバーです。

どのクライアントに対応していますか？ Claude Desktop や Cursor を含め、npx -y genrelay-mcp で stdio サーバーを起動できる任意の MCP クライアントに対応しています。

API キーを取得するにはどうすればよいですか？ genrelay.ai に登録し、コンソールでキーを作成してください。GENRELAY_API_KEY として設定します。

料金はどのように請求されますか？ 米ドル建てのプリペイドクレジットで、使った分だけ支払います。料金をご覧ください。

動画の生成がまだ実行中です。再送信すべきですか？ いいえ。タスク ID を指定して check_job を使用してください。再送信すると、再度請求されます。

どこに掲載されていますか？ npm および公式 MCP Registry に io.github.gaoruitech/genrelay-mcp として掲載されています。

ライセンス

MIT