🚀 Zonos TTS 与 MCP 集成
本项目实现了 Zonos TTS 的 Model Context Protocol（MCP）集成，让 Claude 能够直接生成语音，为语音交互带来更便捷的体验。
🚀 快速开始
安装说明
通过 Smithery 安装
你可以通过 Smithery 自动安装 Zonos TTS 集成，使用以下命令：
npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude
手动安装
- 确保 Zonos 服务器已运行，并且具备我们的 API 实现（PhialsBasement/zonos-api）。
- 安装依赖：
npm install @modelcontextprotocol/sdk axios
- 配置 PulseAudio 访问：
# 确保你的 Pulse Audio 已正确配置以支持音频播放
# MCP 服务器将自动尝试连接到你的脉冲服务器
- 构建 MCP 服务器：
npm run build
# 这将在 dist 文件夹中创建编译后的服务器文件
- 添加到 Claude 的配置文件：
编辑你的 Claude 配置文件（通常位于
~/.config/claude/config.json），并在mcpServers部分添加以下内容：
"zonos-tts": {
"command": "node",
"args": [
"/path/to/your/zonos-mcp/dist/server.js"
]
}
请将 /path/to/your/zonos-mcp 替换为你实际安装 MCP 服务器的路径。
使用方法
配置完成后，Claude 将自动知道如何使用 speak_response 工具，以下是使用示例：
speak_response(
text="Your text here",
language="en-us", # 可选，默认为 en-us
emotion="happy" # 可选："neutral", "happy", "sad", "angry"
)
✨ 主要特性
- 文本到语音（TTS）：通过 Claude 实现文本到语音的转换。
- 多种情感支持：支持多种情感，如中立、快乐、悲伤、愤怒等。
- 多语言支持：支持多种语言。
- 音频播放：通过 PulseAudio 正确播放音频。
📦 安装指南
通过 Smithery 安装
npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude
手动安装
- 确保 Zonos 服务器已运行且具备 API 实现（PhialsBasement/zonos-api）。
- 安装依赖：
npm install @modelcontextprotocol/sdk axios
- 配置 PulseAudio 访问：
# 确保你的 Pulse Audio 已正确配置以支持音频播放
# MCP 服务器将自动尝试连接到你的脉冲服务器
- 构建 MCP 服务器：
npm run build
# 这将在 dist 文件夹中创建编译后的服务器文件
- 添加到 Claude 的配置文件：
编辑
~/.config/claude/config.json，在mcpServers部分添加：
"zonos-tts": {
"command": "node",
"args": [
"/path/to/your/zonos-mcp/dist/server.js"
]
}
替换 /path/to/your/zonos-mcp 为实际路径。
💻 使用示例
基础用法
speak_response(
text="Your text here",
language="en-us", # 可选，默认为 en-us
emotion="happy" # 可选："neutral", "happy", "sad", "angry"
)
🔧 技术细节
要求
- Node.js 环境
- PulseAudio 配置
- 运行中的 Zonos API 实例（PhialsBasement/zonos-api）
- 正常工作的音频输出设备
> ⚠️ 重要提示
- 确保 Zonos API 服务器和此 MCP 服务器都在运行。
- 音频播放需要正确的 PulseAudio 配置。