Kokoro TTS MCP サーバー

Kokoro TTSエンジンを用いたテキスト読み上げ機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーはMCPツールを通じてTTS機能を公開するため、アプリケーションへの音声合成の統合が容易になります。

前提条件

• Python 3.10以上

• uvパッケージマネージャー

Related MCP server: Typecast API MCP Server

インストール

1. まず、 uvパッケージ マネージャーをインストールします。

curl -LsSf https://astral.sh/uv/install.sh | sh

2. このリポジトリをクローンし、依存関係をインストールします。

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"
      ]
    }
  }
}

ライセンス

[ここにライセンス情報を追加してください]