Kokoro TTS

🚀 Kokoro TTS MCP サーバー

このサーバーは、Kokoro TTS エンジンを使用したテキスト読み上げ（TTS）機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。MCP ツールを通じて TTS 機能を公開し、アプリケーションに音声合成を簡単に統合できるようにします。

🚀 クイックスタート

このセクションでは、Kokoro TTS MCP サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 音声をカスタマイズ可能なテキスト読み上げ合成
• 読み上げ速度を調整可能
• 音声をファイルに保存するか、直接再生することができます
• クロスプラットフォームの音声再生サポート（Windows、macOS、Linux）

📦 インストール

前提条件

• Python 3.10 以上
• uv パッケージマネージャー

インストール手順

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

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

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

uv venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate
uv pip install .

💻 使用例

基本的な使用法

from mcp.client import Client

async with Client() as client:
    await client.connect("kokoro-tts")
    
    # 生成并播放语音
    result = await client.call_tool(
        "generate_speech",
        {
            "text": "你好，世界！",
            "voice": "af_heart",
            "speed": 1.0,
            "play_audio": True
        }
    )

高度な使用法

# このサーバーは、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")
    
    # 生成并播放语音
    result = await client.call_tool(
        "generate_speech",
        {
            "text": "こんにちは、世界！",
            "voice": "af_heart",
            "speed": 1.2,
            "save_path": "./output.wav",
            "play_audio": True
        }
    )

📚 ドキュメント

サーバー提供の MCP ツール generate_speech のパラメータ

依存関係

• kokoro >= 0.8.4
• mcp[cli] >= 1.3.0
• soundfile >= 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"
      ]
    }
  }
}

📄 ライセンス

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