Kokoro TTS MCP 服务器

一个提供文本到语音（TTS）功能的模型上下文协议（MCP）服务器，使用 Kokoro TTS 引擎。该服务器通过 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": "你好，世界！",
            "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"
      ]
    }
  }
}

许可证

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