🚀 语音 MCP 服务器

语音 MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，借助 Kokoro TTS 模型，为用户提供文本到语音的转换功能，能满足多样化的语音需求。

🚀 快速开始

安装

1. 使用 npm 进行全局安装：

npm install -g @decodershq/speech-mcp-server

2. 安装完成后，启动服务器：

npm start

配置环境变量

在启动服务器前，你可以通过设置以下环境变量来自定义服务器的行为：

• MCP_DEFAULT_SPEECH_SPEED：用于调整文本到语音转换的默认速度倍数。
• MCP_DEFAULT_VOICE：用于指定文本到语音转换的默认音调。

调用工具

文本到语音转换

echo '{"type":"request","method":"call_tool","params":{"name":"text_to_speech","arguments":{"text":"Hello world","voice":"af_bella"}}}' | node dist/index.js

列出可用音调

echo '{"type":"request","method":"list_voices","params":{}}' | node dist/index.js

获取模型状态

echo '{"type":"request","method":"get_model_status","params":{}}' | node dist/index.js

集成到 Claude Desktop

若要在 Claude Desktop 中使用此服务器，需在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中添加以下配置内容：

{
  "servers": {
    "speech": {
      "command": "npx",
      "args": ["@decodershq/speech-mcp-server"]
    }
  }
}

✨ 主要特性

• 文本到语音转换：能够将输入的文本转换为自然流畅的语音输出。
• 自定义音调：支持多种音调选择，可根据不同的场景需求进行灵活调整。
• 自动模型初始化：服务器启动时会自动下载并初始化 TTS 模型，无需手动干预。
• 故障恢复机制：当模型初始化失败时，服务器会自动重试，最多重试 3 次，并且在每次重试前会清理旧文件，以确保初始化的顺利进行。

📦 安装指南

环境变量配置

服务器可以通过以下环境变量进行配置：

在 Cursor 中的配置示例

{
  "mcpServers": {
    "speech": {
      "command": "npx",
      "args": [
        "-y",
        "speech-mcp-server"
      ],
      "env": {
        "MCP_DEFAULT_SPEECH_SPEED": 1.3,
        "MCP_DEFAULT_VOICE": "af_bella"
      }
    }
  }
}

💻 使用示例

基础用法

文本到语音转换

echo '{"type":"request","method":"call_tool","params":{"name":"text_to_speech","arguments":{"text":"Hello world","voice":"af_bella"}}}' | node dist/index.js

列出可用音调

echo '{"type":"request","method":"list_voices","params":{}}' | node dist/index.js

获取模型状态

echo '{"type":"request","method":"get_model_status","params":{}}' | node dist/index.js

📚 详细文档

集成到 Claude Desktop

在 Claude Desktop 中使用此服务器时，需要在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中添加如下配置：

{
  "servers": {
    "speech": {
      "command": "npx",
      "args": ["@decodershq/speech-mcp-server"]
    }
  }
}

故障排除

模型初始化问题

如果遇到模型初始化失败的情况，可以按照以下步骤进行处理：

1. 服务器会在每次重试前自动清理旧文件。
2. 使用 get_model_status 工具监控初始化进度和错误信息。
3. 如果所有重试均失败，可以手动删除模型文件：

# 删除模型文件（MacOS/Linux）
rm -rf ~/.npm/_npx/**/node_modules/@huggingface/transformers/.cache/onnx-community/Kokoro-82M-v1.0-ONNX/onnx/model_quantized.onnx
rm -rf ~/.cache/huggingface/transformers/onnx-community/Kokoro-82M-v1.0-ONNX/onnx/model_quantized.onnx

# 然后重启服务器
npm start

get_model_status 工具的响应将包含重试信息：

{
  "content": [{
    "type": "text",
    "text": "模型状态：正在初始化（5 秒已用，重试 1/3）"
  }]
}

📄 许可证

本项目采用 MIT 许可证，详细信息请参阅 LICENSE 文件。