Kokoro TTS

🚀 Kokoro TTS MCP 服務器

Kokoro TTS MCP 服務器是一個基於 Kokoro TTS 引擎的文本到語音（TTS）服務，藉助模型上下文協議（MCP），讓語音合成功能能輕鬆集成到各類應用程序中。

🚀 快速開始

使用此服務器前，請確保滿足以下先決條件：

• Python 3.10 或更高版本
• uv 包管理器

📦 安裝指南

安裝 uv 包管理器

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

克隆倉庫並安裝依賴項

uv venv
source .venv/bin/activate  # 在 Windows 上，請使用：.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")
    
    # 生成並播放語音
    result = await client.call_tool(
        "generate_speech",
        {
            "text": "你好，世界！",
            "voice": "af_heart",
            "speed": 1.0,
            "play_audio": True
        }
    )

📚 詳細文檔

依賴項

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

📄 許可證

[在此處添加您的許可信息]