Zonos TTS MCP Integration 使用说明

项目简介

Zonos TTS MCP Integration 是一个 MCP (Model Context Protocol) 服务器，它集成了 Zonos 文本转语音 (TTS) API，为支持 MCP 协议的客户端（如 Claude）提供文本转语音功能。通过此 MCP 服务器，Claude 等 LLM 应用可以调用 'speak_response' 工具，将文本转换为语音并播放出来。

主要功能点

文本转语音 (TTS)： 允许 Claude 将文本内容转换为自然流畅的语音。
情感支持： 支持多种情感选项（中性、高兴、悲伤、愤怒），使语音更富表现力。
多语言支持： 支持多种语言的文本转语音（取决于 Zonos API 的支持）。
音频播放： MCP 服务器负责处理音频播放，支持 PulseAudio 等音频系统。

安装步骤

安装 Zonos API: 确保已安装并运行 Zonos API。这是 Zonos TTS MCP Integration 的依赖项。

安装依赖: 在你的 Zonos TTS MCP Integration 项目目录中，运行以下命令安装必要的 npm 包：

npm install @modelcontextprotocol/sdk axios

配置 PulseAudio (Linux): 确保你的 Linux 系统 PulseAudio 音频服务配置正确，以便服务器可以播放音频。
构建 MCP 服务器: 运行以下命令编译 TypeScript 代码并生成可执行的 JavaScript 文件：
```
npm run build
```
这将在项目根目录下创建 'dist' 目录，编译后的 'server.js' 文件位于 'dist' 目录中。

服务器配置

要将 Zonos TTS MCP 服务器添加到 Claude 客户端，你需要编辑 Claude 的配置文件 ('~/.config/claude/config.json')，并在 'mcpServers' 部分添加以下配置信息。请根据你的实际安装路径修改 '/path/to/your/zonos-mcp'。

"mcpServers": {
  "zonos-tts": {
    "command": "node",
    "args": [
      "/path/to/your/zonos-mcp/dist/server.js"
    ]
  }
}

配置参数说明:

'"zonos-tts"': 服务器名称，可以自定义，用于在 Claude 客户端中标识该 MCP 服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 解释器来运行 JavaScript 代码。
'"args": ["/path/to/your/zonos-mcp/dist/server.js"]': 传递给 'node' 命令的参数，指定 MCP 服务器 JavaScript 文件的路径。请将 '/path/to/your/zonos-mcp' 替换为 Zonos TTS MCP Integration 项目的实际安装路径。

基本使用方法

配置完成后，Claude 客户端将自动识别并可以使用 'speak_response' 工具。在 Claude 中，你可以像这样调用 'speak_response' 工具：

speak_response(
    text="Your text here",
    language="en-us",  # 可选，默认为 en-us
    emotion="happy"    # 可选，情感选项: "neutral", "happy", "sad", "angry"，默认为 "neutral"
)

'text': 要转换为语音的文本内容。
'language': 指定语言代码，例如 "en-us" (美式英语)。
'emotion': 指定语音情感，可选项包括 "neutral" (中性), "happy" (高兴), "sad" (悲伤), "angry" (愤怒)。

Claude 会将 'speak_response' 工具调用请求发送到 Zonos TTS MCP 服务器。服务器会调用 Zonos API 进行文本转语音，并将生成的音频播放出来。

使用注意事项:

确保 Zonos API 服务器和 Zonos TTS MCP 服务器都已启动并正在运行。
音频播放依赖于 PulseAudio 等音频系统的正确配置。

关键词