article
README
🚀 Zonos TTS 与 MCP 集成
Zonos TTS 与 Model Context Protocol(MCP)集成,可让 Claude 直接生成语音,为语音交互提供了便利。
🚀 快速开始
本集成允许 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"
)
✨ 主要特性
- 文本到语音:通过 Claude 实现文本到语音的转换。
- 多种情感支持:支持多种情感,如中立、快乐、悲伤、愤怒等。
- 多语言支持:支持多种语言。
- 音频播放:通过 PulseAudio 正确播放音频。
🔧 技术细节
要求
- Node.js
- PulseAudio 配置
- 运行中的 Zonos API 实例(PhialsBasement/zonos-api)
- 正常工作的音频输出设备
注意事项
⚠️ 重要提示
确保 Zonos API 服务器和此 MCP 服务器都在运行。
💡 使用建议
音频播放需要正确的 PulseAudio 配置。
微信扫一扫