gemini-omni-mcp

RunAPI Gemini Omni MCP サーバー

AI エージェント向け Gemini Omni API アクセス：マルチモーダル生成操作の実行、非同期結果のポーリング、料金の確認を、用途に特化した 1 つの MCP サーバーで行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換のあらゆるホストで動作します。}

インストール | ツール | モデル | エージェントプロンプト | 設定 | リンク

---

このパッケージを使う理由

@runapi.ai/gemini-omni-mcp は、RunAPI の Gemini Omni モデルシリーズに特化した Model Context Protocol サーバーです。 RunAPI のカタログ全体を読み込まずに、MCP 互換のアシスタントから 3 つのエンドポイントと 5 種類のモデルに直接アクセスできます。

エージェントの対象を Gemini Omni に限定する場合は、このモデル別サーバーを使用してください。1 つのアシスタントで RunAPI のすべてのモデルシリーズを探索する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します：

claude mcp add gemini-omni -s user -- npx -y @runapi.ai/gemini-omni-mcp

サーバーをリポジトリと共有する場合は、プロジェクトスコープを使用します：

claude mcp add gemini-omni -s project -- npx -y @runapi.ai/gemini-omni-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code、およびその他の MCP ホストでも、同じ stdio コマンドを使用できます：

{
  "mcpServers": {
    "gemini-omni": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/gemini-omni-mcp"]
    }
  }
}

サインイン前でも check_pricing を使用できます。タスクの作成とステータスのポーリングを行うには、アシスタントに login ツールを呼び出すよう依頼してください。ブラウザーでログイン画面が開き、runapi login と同じ ~/.config/runapi/config.json ファイルに認証情報が保存されます。 ヘッドレス環境や CI ホストでは、MCP ホストの起動前に RUNAPI_API_KEY を設定して使用することもできます。

Claude、Cursor、Windsurf、VS Code、Roo Code 向けのすぐに使える例は、examples/ にあります。

---

ツール

ツール	認証	用途
create_audio	必要	Gemini Omni の音声作成操作を同期的に実行します。操作の結果を返します。
create_character	必要	Gemini Omni のキャラクター作成操作を同期的に実行します。操作の結果を返します。
text_to_video	必要	Gemini Omni のテキストから動画を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	必要	既存タスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Gemini Omni のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Gemini Omni は、3 つのエンドポイントで 5 種類のモデルに対応しています。各ツールで、対応するモデルを利用できます：

ツール	モデル
create_audio	gemini-omni-audio
create_character	gemini-omni-character
text_to_video	gemini-omni-flash-1-1、gemini-omni-flash-preview、gemini-omni-text-to-video

モデルの提供状況はリリースごとに変わる場合があります。最新のカタログは、check_pricing または Gemini Omni モデルページ で確認してください。

---

エージェントプロンプト

自然言語でアシスタントに依頼すると、料金の確認、タスクの作成を行い、タスク ID と出力 URL を返します。

タスクを作成する

Run a Gemini Omni text to video task with RunAPI.

アシスタントは check_pricing を呼び出してから text_to_video を呼び出し、タスク ID、ステータス、出力 URL を返します。

待機せずに送信

Create the task but don't wait for it to finish.

アシスタントは wait: false を指定して create ツールを呼び出し、タスク ID を返します。後で get_task を使って確認してください。

作成前に料金を確認

Check current Gemini Omni pricing, then create the task if it matches my request.

アシスタントは check_pricing を呼び出し、正規のカタログ項目として Gemini Omni model page へのリンクを示せます。

---

設定

サーバーは次の順序で認証情報を解決します。

1. RUNAPI_API_KEY 環境変数。ヘッドレスホストや CI ホストで便利です
2. ~/.config/runapi/config.json。MCP の login ツールまたは runapi login によって作成されます
3. キーなし。この場合も check_pricing は使用できます

設定ファイルは通常、login によって管理されます。事前に設定されたヘッドレス用の設定は、次のように指定できます。

{
  "apiKey": "your_runapi_key"
}

実際の API キーをコミットしないでください。

---

リンク

リソース	URL
Gemini Omni モデルページ	https://runapi.ai/models/gemini-omni
npm パッケージ	@runapi.ai/gemini-omni-mcp
GitHub リポジトリ	runapi-ai/gemini-omni-mcp
RunAPI MCP の概要	runapi.ai/mcp
RunAPI ドキュメント	runapi.ai/docs

---

ライセンス

Apache License, Version 2.0 の下でライセンスされています。