Zonos-TTS-MCP

🚀 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

手动安装

1. 确保 Zonos 服务器已运行，并且具备我们的 API 实现（PhialsBasement/zonos-api）。
2. 安装依赖：

npm install @modelcontextprotocol/sdk axios

3. 配置 PulseAudio 访问：

# 确保你的 Pulse Audio 已正确配置以支持音频播放
# MCP 服务器将自动尝试连接到你的脉冲服务器

4. 构建 MCP 服务器：

npm run build
# 这将在 dist 文件夹中创建编译后的服务器文件

5. 添加到 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

手动安装

1. 确保 Zonos 服务器已运行且具备 API 实现（PhialsBasement/zonos-api）。
2. 安装依赖：

npm install @modelcontextprotocol/sdk axios

3. 配置 PulseAudio 访问：

# 确保你的 Pulse Audio 已正确配置以支持音频播放
# MCP 服务器将自动尝试连接到你的脉冲服务器

4. 构建 MCP 服务器：

npm run build
# 这将在 dist 文件夹中创建编译后的服务器文件

5. 添加到 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 配置。