🚀 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"
]
}
}
}
📄 许可证
[在此处添加您的许可信息]