MCP TTS服务器
基于模型上下文协议（MCP）框架构建的多功能TTS（文本到语音）服务器。该服务器通过统一接口提供对多个TTS引擎的访问：
- 科科罗TTS -高品质的本地TTS引擎
- OpenAI TTS -通过OpenAI的API实现基于云的TTS
特性
- 🌐 一个统一服务器中的多个TTS引擎
- 🎧 实时流媒体音频播放
- 🔄 MCP协议支持与Claude和其他LLM无缝集成
- 🎛️ 两个引擎均可配置语音选择
- 💬 支持通过自然语言指令进行语音定制（OpenAI）
- ⚡ 两台TTS发动机的速度调节
- 🛑 用于停止音频和清除队列的播放控制
安装
先决条件
- Python 3.10或更高版本
- 紫外线 包管理器
- OpenAI API密钥（用于OpenAI TTS功能）
快速安装
# Clone the repository
git clone https://github.com/kristofferv98/MCP_tts_server.git
cd MCP_tts_server
# Create a virtual environment and install dependencies
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .配置
创建一个 .env 基于提供的文件 .env.example:
cp .env.example .env编辑 .env 文件以添加您的OpenAI API密钥：
OPENAI_API_KEY=your_openai_api_key_here与Claude Desktop集成
要将此服务器与Claude Desktop一起使用，请执行以下操作：
- 安装服务器：
fastmcp install ./tts_mcp.py --name tts- 或者，您可以手动将服务器添加到Claude Desktop的配置文件中：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
将此条目添加到 mcpServers 章节：
"kokoro_tts": {
"command": "uv",
"args": [
"--directory",
"/path/to/MCP_tts_server",
"run",
"tts_mcp.py"
]
}使用uv完整路径的示例配置：
"kokoro_tts": {
"command": "/Users/username/.local/bin/uv",
"args": [
"--directory",
"/Users/username/Documents/MCP_Servers/MCP_tts_server",
"run",
"tts_mcp.py"
]
}MCP功能定义
服务器公开了以下MCP工具：
TTS主要功能
{
"description": "Convert text to speech using the preferred engine and streams the speech to the user. The base voice for the AI is the Kokoro engine, to keep AI's personality consistent. This unified function provides access to both Kokoro TTS (local) and OpenAI TTS (cloud API).",
"name": "tts",
"parameters": {
"properties": {
"text": {"title": "Text", "type": "string"},
"engine": {"default": "kokoro", "title": "Engine", "type": "string"},
"speed": {"default": 1, "title": "Speed", "type": "number"},
"voice": {"default": "", "title": "Voice", "type": "string"},
"instructions": {"default": "", "title": "Instructions", "type": "string"}
},
"required": ["text"]
}
}参数：
- 文本 （必填）：文本转换为语音
- 发动机 （可选）：要使用的TTS引擎-“kokoro”（默认，本地）或“openai”（云）
- 速度 （可选）：播放速度（典型值为0.8-1.5）
- 声音 （可选）：要使用的语音名称（特定于发动机）
- 说明 （可选）：OpenAI TTS的语音定制说明
停止播放功能
{
"description": "Stops the currently playing audio (if any) and clears all pending TTS requests from the queue. Relies on the background worker detecting the cancellation signal.",
"name": "tts_stop_playback_and_clear_queue",
"parameters": {
"properties": {}
}
}语音示例功能
{
"description": "Provides research-based examples of effective voice instructions for OpenAI TTS.",
"name": "tts_examples",
"parameters": {
"properties": {
"category": {"default": "general", "title": "Category", "type": "string"}
}
}
}类别：
- 通用
- 口音
- 字符
- 情绪
- 旁白
获取TTS指令功能
{
"description": "Fetches TTS instructions by calling get_voice_info.",
"name": "get_tts_instructions",
"parameters": {
"properties": {}
}
}直接使用
使用此服务器的主要方式是通过如上所述的Claude Desktop或其他MCP支持的集成。但是，您也可以直接运行服务器进行测试：
# Run with the uv environment manager
uv run python tts_mcp.py
# Or use the simplified Kokoro-only version
uv run python simple_tts_mcp.py这将启动MCP服务器，使其可用于连接。
可用声音
科科罗TTS
- 默认语音：
af_heart
OpenAI TTS
- 可用语音：
alloy,ash,ballad,coral,echo,fable,onyx,nova,sage,shimmer - 默认型号：
gpt-4o-mini-tts
开发和测试
在开发过程中本地测试服务器：
fastmcp dev ./tts_mcp.py这将启动MCP检查器界面，您可以在其中测试服务器的功能。
实现细节
该服务器使用FastMCP实现，并遵循MCP服务器开发的最佳实践：
- 统一接口：一个函数同时支持Kokoro和OpenAI引擎
- 流媒体支持：尽可能将音频直接流式传输到客户端
- 回退机制：流媒体不可用时基于文件的播放
- 语音定制：OpenAI TTS支持自然语言指令
- 寿命管理：正确初始化和清理资源
故障排除
- 无音频输出：检查系统的音频配置
- OpenAI TTS故障：验证您的API密钥是否有效并具有TTS访问权限
- 找不到服务器：确保MCP服务器在MCP主机中正确注册
许可证
此项目在Apache License 2.0下获得许可-有关详细信息，请参阅License文件。
贡献
欢迎投稿！请随时提交拉取请求。