mcp-kokoro-tts
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-provisionRelated MCP server: mac-say-mcp
エージェントに呼び出させる
AGENTS.md / CLAUDE.md / システムプロンプトに1行追加します:
When the user wants to hear something spoken aloud, call the `speak` tool with clear, natural text.ツール
speak
音声を合成し、WAVファイルを書き出して、ローカルで再生します。
パラメータ | 必須 | 説明 |
| はい | 読み上げるテキスト(最大500文字) |
| いいえ | 音声ID(例: |
| いいえ | 再生速度の倍率(デフォルト |
list_voices
利用可能なKokoroの音声と、現在選択されているデフォルトを一覧表示します。
音声の選択
解決順:
TTS_VOICE環境変数 — 音声IDまたは絶対パスの.ptパスパッケージの
voices/フォルダ内で名前がdefaultで始まるファイルvoices/内の最初の.ptファイル(アルファベット順)モデルに同梱の
af_heart音声
{
"mcpServers": {
"mcp-kokoro-tts": {
"command": "uvx",
"args": ["mcp-kokoro-tts"],
"env": {
"TTS_VOICE": "af_heart"
}
}
}
}環境変数
変数 | 説明 |
| デフォルトの音声IDまたは絶対パスの |
| モデルキャッシュディレクトリを上書き |
| Hugging Faceハブのキャッシュディレクトリを上書き |
| 生成されたWAVファイルのディレクトリ |
|
|
| ダウンロードを高速化するためのオプションのHugging Faceトークン |
プラットフォーム
OS | 合成 | 再生 |
macOS | 対応 |
|
Linux | 対応 |
|
Windows | 対応 | PowerShell |
espeak-ngはオプションです。英語はこれなしで動作します。語彙外(out-of-vocabulary)のカバレッジを向上させ、一部の非英語言語を扱うにはインストールしてください。
公開
バージョンにタグを付けるとGitHub Actionsのpublish.ymlが実行され、PyPIにアップロードした後、MCP Registryにアップロードします。
PyPIへの公開には、リポジトリのシークレットPYPI_TOKEN(PyPI APIトークン)を使用します。GitHubのtrusted publishingはPyPIプロジェクト側でも設定できます。このワークフローはトークンで認証するため、初回リリースはpending-publisherのマッチングに依存しません。
リリース
pyproject.tomlのversionを上げます(まだタグを付けない場合はserver.jsonも)コミットしてタグを付けます:
ギgit tag v0.1.2 && git push origin v0.1.2GitHub 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ライセンスのもとで別途ダウンロードされます。
Available Tools
2 toolslist_voicesList voicesA
List Kokoro voices available to the speak tool and the currently selected default voice. Resolution order: TTS_VOICE env var, voices/default* file, first file in voices/, then the model's default af_heart voice.
Inputs: no named parameters. Returns: result
speakSpeakA
Synthesize speech with Kokoro-82M and play it on the user's machine. Call this when the user wants the harness to talk, read something aloud, or hear a spoken response. Always pass clear, natural text to speak. Default voice resolution: TTS_VOICE env var, voices/default* in the package, first file in voices/, then the bundled af_heart voice from the model.
Inputs: text (required), speed, voice. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one performs speech synthesis ('speak'), the other lists available voices ('list_voices'). No ambiguity between them, as they serve complementary roles in the TTS workflow.
Both tool names follow an imperative verb style ('speak', 'list_voices'), which is concise and predictable. 'list_voices' uses a verb_noun pattern, but the naming is consistent in tone and clarity for a small set.
With only 2 tools, the server is minimal yet well-scoped for its purpose: a text-to-speech harness. The count is appropriate; additional tools would likely be redundant.
The core operation (speak) is present, and the companion list_voices provides necessary context for voice selection. Minor gaps exist, such as no pause/stop or voice configuration tool, but these are not critical for basic TTS functionality.
Maintenance
Related MCP Connectors
MCP server for Text-to-Speech
Hosted text-to-speech MCP server: 66 voices in 9 languages, long-form narration, podcasts.
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
AI voice generation: text-to-speech and voice cloning from any MCP client.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables users to convert text into high-quality audio by accessing the OpenAI Text-to-Speech API. It supports customizable model selection and voice options for synthesized speech generation via the MCP protocol.1MIT
- AlicenseAqualityDmaintenanceMCP server for text-to-speech using macOS say command, enabling speech synthesis, audio file generation, and voice management.51MIT

leanvox-mcpofficial
AlicenseNot gradedqualityDmaintenanceEnables text-to-speech generation, voice cloning, dialogue creation, and other TTS operations through natural language in MCP-compatible AI assistants.10 npmMIT- AlicenseNot gradedqualityDmaintenanceEnables MCP clients to speak by running local voice models using Chatterbox Turbo TTS or Kokoro TTS, with support for voice cloning, paralinguistic tags, and multiple voices.89 npm13MIT