Voice Mode MCP 接入 Fish Audio TTS

Voice Mode 为 Claude Code 等支持 MCP 的客户端提供双向语音能力。它可以把 Fish Audio 的 OpenAI 兼容接口加入 TTS 服务列表。

配置环境变量

在 MCP Server 配置的 env 中加入：

{
  "OPENAI_API_KEY": "YOUR_API_KEY",
  "VOICEMODE_TTS_BASE_URLS": "https://fishaudio.org/v1",
  "VOICEMODE_TTS_MODEL": "fishaudio-s21pro-flash",
  "VOICEMODE_TTS_VOICE": "00a1b221-6137-4b73-ad62-b0cbce134167"
}

也可以写入 ~/.voicemode/voicemode.env：

export OPENAI_API_KEY="YOUR_API_KEY"
export VOICEMODE_TTS_BASE_URLS="https://fishaudio.org/v1"
export VOICEMODE_TTS_MODEL="fishaudio-s21pro-flash"
export VOICEMODE_TTS_VOICE="00a1b221-6137-4b73-ad62-b0cbce134167"

旧变量 TTS_BASE_URL、TTS_MODEL 和 TTS_VOICE 仍受支持，但新配置建议使用 VOICEMODE_ 前缀。

测试和更换音色

重启 MCP 客户端，使 Voice Mode Server 重新读取环境变量。发起一段简短语音对话，确认能够播放合成结果后，再把测试音色替换为自己的 音色 ID。

如果同时配置多个 TTS URL，Voice Mode 可能按顺序尝试回退服务。排查 Fish Audio 接入时，先只保留 https://fishaudio.org/v1。

常见问题

• 仍使用其他语音服务：检查 VOICEMODE_TTS_BASE_URLS 中是否保留了其他地址。
• 找不到 API Key：确保变量位于启动 MCP Server 的进程环境中。
• 模型或音色无效：使用 Fish Audio 模型 ID 和音色 ID，不使用 OpenAI 默认名称。
• 401/402：重新检查 Key 和 API 积分。

相关文档

• API 身份验证
• OpenAI 兼容 TTS
• Voice Mode 环境变量参考