Kokoro TTS MCP 服务器

一个使用 Kokoro TTS 引擎提供文本到语音转换功能的模型上下文协议 (MCP) 服务器。该服务器通过 MCP 工具公开 TTS 功能，从而可以轻松地将语音合成集成到您的应用程序中。

前提条件

• 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 .

功能

• 具有可自定义声音的文本到语音合成
• 可调节的语速
• 支持将音频保存到文件或直接播放
• 跨平台音频播放支持（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": "Hello, world!",
            "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"
      ]
    }
  }
}

许可证

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