mcp-kokoro-tts

ローカルKokoro-82Mテキスト読み上げMCPサーバーです。エージェントがspeakを呼び出すと、音声を合成してあなたのマシンで再生するため、ハーネスが話すのを聞くことができます。

あらゆるMCPクライアントで動作します：Claude Desktop、Claude Code、Cursor、VS Code、opencode、Clineなど。短い設定ブロックを1つ追加するだけで、APIキーは不要です。音声合成はKokoro-82Mでローカルに実行されます。

初回起動時に、サーバーはPyPIにない2つのものを用意します: Kokoro-82Mの重みデータ（約312 MB）をローカルキャッシュへ、spaCyの英語モデル（en_core_web_sm）をサーバーが実行しているのと同じPython環境へ。この2つ目のインストールが必要なのは、KokoroのG2PパイプラインがspaCyを読み込むためです。uvx / uv tool環境には、このパッケージが配置しない限りモデルが存在しません。

インストール

クライアントのMCP設定に追加します：

{
  "mcpServers": {
    "mcp-kokoro-tts": {
      "command": "uvx",
      "args": ["mcp-kokoro-tts"]
    }
  }
}

Python 3.12とuvが必要です。最初のサーバー起動時に、Kokoroの重みデータとspaCy英語モデルが自動的に用意されます。

MCPサーバーを起動せずに両方を事前にダウンロードするには：

uvx mcp-kokoro-tts-provision

Related MCP server: MCP TTS Server

エージェントに呼び出させる

AGENTS.md / CLAUDE.md / システムプロンプトに1行追加します：

When the user wants to hear something spoken aloud, call the `speak` tool with clear, natural text.

ツール

speak

音声を合成し、WAVファイルを書き出して、ローカルで再生します。

list_voices

利用可能なKokoroの音声と、現在選択されているデフォルトを一覧表示します。

音声の選択

解決順：

1. TTS_VOICE 環境変数 — 音声IDまたは絶対パスの.ptパス

2. パッケージのvoices/フォルダ内で名前がdefaultで始まるファイル

3. voices/内の最初の.ptファイル（アルファベット順）

4. モデルに同梱のaf_heart音声

{
  "mcpServers": {
    "mcp-kokoro-tts": {
      "command": "uvx",
      "args": ["mcp-kokoro-tts"],
      "env": {
        "TTS_VOICE": "af_heart"
      }
    }
  }
}

環境変数

プラットフォーム

espeak-ngはオプションです。英語はこれなしで動作します。語彙外(out-of-vocabulary)のカバレッジを向上させ、一部の非英語言語を扱うにはインストールしてください。

公開

バージョンにタグを付けるとGitHub Actionsのpublish.ymlが実行され、PyPIにアップロードした後、MCP Registryにアップロードします。

PyPIへの公開には、リポジトリのシークレットPYPI_TOKEN（PyPI APIトークン）を使用します。GitHubのtrusted publishingはPyPIプロジェクト側でも設定できます。このワークフローはトークンで認証するため、初回リリースはpending-publisherのマッチングに依存しません。

リリース

1. pyproject.tomlのversionを上げます（まだタグを付けない場合はserver.jsonも）

2. コミットしてタグを付けます: ギgit tag v0.1.2 && git push origin v0.1.2

3. GitHub Actionsがpublish.ymlを実行します:

   • release — 型チェック、テスト、wheel/sdistのビルド

   • pypi-publish — PYPI_TOKENでPyPIにアップロード

   • mcp-registry — OIDC → MCP Registry（PyPI成功後）

開発

cd mcps-tts
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pyright
pytest
python -m mcp_kokoro_tts

ライセンス

Apache-2.0です。LICENSEとNOTICEを参照してください。Kokoro-82Mモデルの重みデータは、Apache-2.0ライセンスのもとで別途ダウンロードされます。