Kokoro TTS MCP サーバー
Kokoro TTSエンジンを用いたテキスト読み上げ機能を提供するモデルコンテキストプロトコル(MCP)サーバーです。このサーバーはMCPツールを通じてTTS機能を公開するため、アプリケーションへの音声合成の統合が容易になります。
前提条件
- Python 3.10以上
uv
パッケージマネージャー
インストール
- まず、
uv
パッケージ マネージャーをインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh
- このリポジトリをクローンし、依存関係をインストールします。
uv venv
source .venv/bin/activate # On Windows, use: .venv\Scripts\activate
uv pip install .
特徴
- カスタマイズ可能な音声によるテキスト音声合成
- 音声速度を調整可能
- オーディオをファイルに保存したり直接再生したりできるサポート
- クロスプラットフォームのオーディオ再生サポート (Windows、macOS、Linux)
使用法
サーバーは、次のパラメータを持つ単一の MCP ツールgenerate_speech
提供します。
text
(必須): 音声に変換するテキストvoice
(オプション): 合成に使用する音声 (デフォルト: "af_heart")speed
(オプション):音声速度の乗数(デフォルト:1.0)save_path
(オプション): オーディオファイルを保存するディレクトリplay_audio
(オプション): オーディオをすぐに再生するかどうか (デフォルト: False)
使用例
from mcp.client import Client
async with Client() as client:
await client.connect("kokoro-tts")
# Generate and play speech
result = await client.call_tool(
"generate_speech",
{
"text": "Hello, world!",
"voice": "af_heart",
"speed": 1.0,
"play_audio": True
}
)
依存関係
- ココロ >= 0.8.4
- mcp[cli] >= 1.3.0
- サウンドファイル >= 0.13.1
プラットフォームサポート
オーディオ再生は以下でサポートされています:
- Windows (
start
を使用) - macOS (
afplay
を使用) - Linux (
aplay
を使用)
MCP構成
MCP 設定ファイルに次の構成を追加します。
{
"mcpServers": {
"kokoro-tts": {
"command": "/Users/giannisan/pinokio/bin/miniconda/bin/uv",
"args": [
"--directory",
"/Users/giannisan/Documents/Cline/MCP/kokoro-tts-mcp",
"run",
"tts-mcp.py"
]
}
}
}
ライセンス
[ここにライセンス情報を追加してください]