Kokoro Speech

🚀 語音 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 文件。