tts

Brainiall TTS MCP サーバー

Model Context Protocol を介して AI エージェントにテキスト読み上げを提供するホステッドサービスです。

ニューラル音声 54 種類、9 言語 — ネイティブのブラジルポルトガル語（pf_dora、pm_alex、pm_santa）を含み、従量課金制のホステッド API から提供します。GPU もモデルのダウンロードも ElevenLabs のサブスクリプションも不要です。必要なのは API キー 1 つだけで、1,000 文字あたり 0.008 ドルです（登録すると 10 ドル分の無料クレジットが付与されます）。

このサーバーを選ぶ理由

他の TTS MCP サーバーは、モデルをローカルで実行する（負荷が大きく、セットアップにも時間がかかります）か、すでにサブスクリプション料金を支払っているサードパーティーのキーを使用します。このサーバーは、従量課金制のホステッド API です。

• セットアップ不要 — リモートサーバーのため、インストールは不要です
• 使った分だけ支払い — 1,000 文字あたり 0.008 ドルで、Brainiall の残高から請求されます
• 10 ドル分の無料クレジット — app.brainiall.com から登録してください
• WAV 出力 — 16 ビット PCM、24 kHz モノラル。再生可能な MCP 音声コンテンツまたは Base64 JSON として返されます

クイックスタート

app.brainiall.com で API キーを取得してください（ウェルカムクレジット 10 ドル分、カード登録不要）。

VS Code / GitHub Copilot

このボタンを使うと、リモートサーバーが探索モードでインストールされるため、VS Code ではシークレットを設定せずにツールの一覧を表示できます。Brainiall API キーを追加するまでは、音声合成は安全のため失敗するようになっています。一度だけ入力を求め、キーを VS Code のシークレットストレージに保存する安全なワークスペース設定を使うには、.vscode/mcp.json をプロジェクトにコピーするか、このリポジトリをクローンしてから、MCP: List Servers で brainiallTts を起動してください。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "brainiall-api-key",
      "description": "Brainiall API key",
      "password": true
    }
  ],
  "servers": {
    "brainiallTts": {
      "type": "http",
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer ${input:brainiall-api-key}"
      }
    }
  }
}

サーバーが起動したら、次のように試してください。

Brainiall TTS を使ってブラジルポルトガル語の音声を一覧表示し、pf_dora で「Olá do VS Code」と読み上げてください。

インストール URL の形式とシークレット入力の設定は、VS Code の公式 MCP ガイドおよび設定リファレンスに準拠しています。

GitHub Copilot クラウドエージェント

Copilot クラウドエージェントまたは Copilot コードレビューには、制限付きリモートサーバー設定を使用してください。Brainiall の 3 つのツールのみを許可リストに登録し、リポジトリの COPILOT_MCP_BRAINIALL_API_KEY Agents シークレットから Bearer トークンを解決します。API キーはコミットされません。

Continue（VS Code / JetBrains）

すぐに使える Continue MCP ブロックを .continue/mcpServers/brainiall-tts.yaml にコピーし、 .continue/.env に BRAINIALL_API_KEY=your-key を設定してください。 この .env ファイルはバージョン管理の対象外にしてください。

このブロックは Continue がサポートする streamable-http トランスポートを使用し、 ${{ secrets.BRAINIALL_API_KEY }} を通じてキーを解決します。認証情報はコミットされません。 Continue のセットアップとスモークテストを参照してください。

Dify のビルダー

Dify の音声ワークフローには、オープンソースの BRAINIALL Speech プロバイダーを使用し、API キーは Dify の認証情報ストアに保管してください。範囲を限定した Dify インテントルートでは、呼び出し元が管理する境界について説明しています。これは Dify との提携を示すものでも、本番環境での動作を保証するものでもありません。

リモートサーバー（推奨 — インストール不要）

Codex CLI／IDE／ChatGPT デスクトップアプリ

プロジェクト単位の Codex 設定を使用してください。環境変数から BRAINIALL_API_KEY を読み込み、Brainiall の 3 つのツールを許可リストに登録し、 呼び出しごとに確認を求めます。

Claude Code

環境変数を利用する Claude Code 設定を使用してください。キーを .mcp.json に保存せず、サーバーの対象を現在のプロジェクトに限定し、外部データと従量課金の境界について説明しています。

Claude Desktop／.mcp.json 形式の設定を使用するクライアント

{
  "mcpServers": {
    "brainiall-tts": {
      "type": "http",
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "brainiall-tts": {
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
      }
    }
  }
}

LM Studio

LM Studio セットアップガイドに記載されている、公式のワンクリックディープリンクと、ローカルモデルのプライバシーに関する明確な境界を使用してください。

OpenCode v2

OpenCode v2 セットアップガイドに記載されている、リモートサーバースキーマと環境変数を利用する Bearer ヘッダーを使用してください。

Msty Studio

Streamable HTTP 接続には、Msty Studio 手動ガイドを使用してください。 リファレンスファイルは、公式インテグレーションやインポート用プリセットとして提示されていません。

Hugging Face Chat UI（セルフホスト）

管理者向け MCP_SERVERS の例 と、ツールに対応したモデルを使用してください。このガイドでは、基本サーバーにおける共有キーの境界について説明しています。

/v1/audio/speech が必要なクライアント

クライアントで OpenAI 形式の音声ルートを設定できても、Brainiall のネイティブエンドポイントを呼び出せない場合は、依存関係ゼロの部分的な OpenAI 形式 TTS アダプターを使用してください。このアダプターは WAV のみを返し、WAV ヘッダーで確認したサンプルレートを明示し、従量課金されるリクエストを再試行せず、互換性の正確な制限を説明しています。これはローカルのリファレンスアダプターであり、ホスト型の Brainiall API がネイティブに OpenAI 互換であることを示すものではありません。

ローカルで実行する（stdio 不使用、ホスト型 API は引き続き呼び出します）

サーバー自体は薄いラッパーです。セルフホストすると、キーを使って api.brainiall.com にプロキシします。

docker build -t brainiall-tts-mcp .
docker run -p 8080:8080 -e APIM_KEY=YOUR_BRAINIALL_API_KEY brainiall-tts-mcp
# MCP endpoint: http://localhost:8080/mcp

ツール

ツール	説明	費用
synthesize_speech	テキスト（最大 5000 文字）を WAV 音声に変換します。パラメーター：text、language（デフォルトは pt）、voice、speed（0.5～2.0）、output_format（audio | base64_json）	1000 文字あたり $0.008
list_voices	言語、性別、アクセント、品質評価を含む音声カタログ全体です。language フィルターは任意です	無料
check_tts_service	バックエンドのヘルスステータス	無料

音声

言語	音声
ポルトガル語（ブラジル）	pf_dora、pm_alex、pm_santa
英語（米国）	af_heart、af_bella、af_nova、am_adam、am_michael ＋ 14 種類
英語（英国）	bf_alice、bf_emma、bm_daniel、bm_george ＋ 4 種類
スペイン語	ef_dora、em_alex、em_santa
フランス語	ff_siwis、fm_gilles
イタリア語	if_sara、im_nicola
ヒンディー語	hf_alpha、hf_beta、hm_omega、hm_psi
日本語	jf_alpha、jf_gongitsune、jm_kumo ＋ 2 種類
中国語（標準語）	zf_xiaoxiao、zm_yunxi ＋ 6 種類

例

エージェントに次のように依頼します：

「この段落を、女性の声でブラジルポルトガル語で読み上げてください」

エージェントは synthesize_speech(text=..., language="pt", voice="pf_dora") を呼び出し、再生可能な WAV 音声を受け取ります。

ナレーション、アクセシビリティ、語学学習、エージェントのアラート向けのコピーしてすぐ使えるプロンプトとスモークテストについては、エージェントのワークフローレシピをご覧ください。

REST クライアントのテストと自動化には、Postman コレクションをインポートしてください。ヘルスチェック、音声リスト、2 文字の合成スモークテストが含まれており、API キーはリクエスト URL ではなくコレクション変数に保存されます。

ノーコード自動化には、n8n のテキストから WAV へのワークフローをインポートしてください。ワークフローにキーを埋め込む代わりに n8n の Header Auth 認証情報を使用し、編集可能なテキスト、音声、速度の各フィールドをホストされた API に送信して、WAV をバイナリプロパティ speech で返します。テンプレートは静的に検証済みです。認証情報を選択し、ご自身の n8n インスタンスで実行して、実際の連携を検証してください。

コード生成、API クライアント、ディレクトリ内での検索には、機械可読な OpenAPI 3.1 仕様を使用してください。この仕様では、API キーを埋め込むことなく、認証が必要な音声カタログと WAV 合成エンドポイントについて説明しています。

認証と課金

Brainiall API キーを Bearer トークンとして渡してください（上記の設定を参照）。利用量はアカウント残高に対して文字単位で計測されます。同じキーで、すべての Brainiall API（STT、OCR、NLP、画像など、brainiall.comで提供）を利用できます。

エンドポイント

• MCP（Streamable HTTP）：https://api.brainiall.com/mcp/tts/mcp
• ヘルスチェック：https://api.brainiall.com/mcp/tts/health
• 基盤となる REST API：POST https://api.brainiall.com/v1/tts/synthesize

ライセンス

MIT