gemini-tts-mcp

RunAPI Gemini TTS MCP サーバー

AI エージェントから Gemini TTS API にアクセスできます。音声生成操作の実行、非同期結果のポーリング、料金の確認を、特化型の MCP サーバー 1 つで行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換ホストで利用できます。}

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

---

このパッケージを選ぶ理由

@runapi.ai/gemini-tts-mcp は、RunAPI の Gemini TTS モデル系列に特化した Model Context Protocol サーバーです。 MCP 互換のアシスタントから、RunAPI のカタログ全体を読み込まずに、1 つのエンドポイントと 2 種類のモデルを直接利用できます。

エージェントの対象を Gemini TTS に限定したい場合は、このモデル専用サーバーを使用してください。1 つのアシスタントから RunAPI のすべてのモデル系列を見つけたい場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します。

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

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

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

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

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

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

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

---

ツール

ツール	認証	用途
text_to_speech	必要	Gemini TTS のテキスト読み上げタスクを作成し、必要に応じて終端ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	必要	既存タスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Gemini TTS のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Gemini TTS は、1 つのエンドポイントで 2 種類のモデルを提供します。各ツールで、対応するモデルを指定できます。

ツール	モデル
text_to_speech	gemini-2.5-pro-tts、gemini-3.1-flash-tts

モデルの提供状況はリリースごとに変わる場合があります。現在のカタログを確認するには、check_pricing または Gemini TTS モデルページ をご利用ください。

---

エージェントプロンプト

アシスタントに自然な言葉で依頼してください。料金を確認し、タスクを作成して、タスク ID と出力 URL を返せます。

タスクを作成する

Run a Gemini TTS text to speech task with RunAPI.

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

待機せずに送信する

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

アシスタントは wait: false を指定して作成ツールを呼び出し、タスク ID を返します。後で get_task を使って状況を確認できます。

作成前に料金を確認する

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

アシスタントは check_pricing を呼び出します。また、正式なカタログ項目として Gemini TTS モデルページ へのリンクを提示できます。

---

設定

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

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

設定ファイルは通常、ログインによって管理されます。事前にプロビジョニングするヘッドレス環境用の設定では、次のようにできます。

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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