Kokoro TTS

🚀 Kokoro TTS MCP 服务器

Kokoro TTS MCP 服务器是一个借助 Kokoro TTS 引擎，提供文本到语音（TTS）功能的模型上下文协议（MCP）服务器。它通过 MCP 工具公开 TTS 功能，能让您轻松将语音合成集成到应用程序中。

🚀 快速开始

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

📄 许可证

[在此处添加您的许可信息]