fish-speech-mcp

fish-speech-mcp

用于大模型文本转语音合成（TTS）的 MCP 服务。

功能

• 文本转语音：使用 FishSpeech 将文本转换为语音
• 保存语音参考：保存语音参考
• MCP 集成：可与 Dive 及其他兼容 MCP 的大模型配合使用

安装

暂不可用

使用 Dive Desktop

1. 在 Dive Desktop 中点击“+ Add MCP Server”
2. 复制并粘贴此配置：

{
  "mcpServers": {
    "fish-speech": {
      "command": "npx",
      "args": [
        "-y",
        "@demon24ru/fish-speech-mcp"
      ]
    }
  }
}

3. 点击“Save”以安装 MCP 服务

配置

可以使用环境变量配置 MCP 服务：

• MCP_FISH_SPEECH_SERVER_URL：Optivus 服务的 URL（默认值：http://localhost:5000）

工具文档

• text_to_speech

  • 使用 FishSpeech 将文本转换为语音
  • 输入：
    • text（字符串，必填）：要转换为语音的文本
    • reference_id（字符串，可选）：已保存语音的标识符

• save_voice_reference

  • 保存语音参考，以供日后进行语音克隆
  • 输入：
    • reference_audio（字符串，必填）：用于语音克隆的音频文件路径
    • reference_text（字符串，必填）：与用于语音克隆的音频文件对应的文本

技术详情

与 Optivus 服务通信

MCP 服务使用 Socket.IO 与 Optivus 服务通信。通信流程如下：

1. MCP 服务使用 Socket.IO 客户端连接到 Optivus 服务
2. 使用 message 事件向服务发送请求
3. 使用 message 事件接收服务的响应
4. MCP 服务自动处理连接、重连和错误情况

语音参考

语音参考存储在 Optivus 的目录中。每个参考都存储在一个以唯一 ID 命名的子目录中。

使用示例

让你的大模型：

"Convert this text to speech: Text to convert, Reference ID"
"Save a voice reference: Path to audio file, Text corresponding to the audio file"

手动启动

如有需要，可手动启动服务：

npx @demon24ru/fish-speech-mcp

调试

如有需要，可在调试模式下启动服务：

npm run prepare
npx @modelcontextprotocol/inspector node ./lib/index.mjs -y

要求

• Node.js 20+
• 兼容 MCP 的大模型服务

许可证

MIT

作者

@demon24ru