Kokoro TTS MCP Server

这是一个使用Kokoro TTS引擎提供文本转语音功能的Model Context Protocol (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"
      ]
    }
  }
}

许可证

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