Voicevox MCP Server

🚀 語音合成服務器 Voicevox MCP

這是一個藉助 Model Context Protocol (MCP)，能夠使用 Voicevox、AivisSpeech 或 COEIROINK 的語音合成服務器。它適用於在 Cursor 等工具中，於 Claude 3.7 的代理模式下進行語音合成。

🚀 快速開始

必要條件

Windows 環境

• Node.js 18 版本或更高
• 已安裝並運行的 Voicevox ENGINE（可在本地通過 http://localhost:50000 訪問）
• VLC 媒體播放器（已添加到系統路徑）

Docker 環境 (WSL2)

• 安裝 Docker 和 Docker Compose
• 具備 WSL2 環境
• 已安裝並運行的 Voicevox ENGINE（本地或 Docker 內部）
• 在 Linux 系統上已安裝 sudo apt install libsdl2-dev pulseaudio-utils pulseaudio
• 對 /mnt/wslg 有訪問權限

安裝與配置

1. 克隆代碼庫

git clone https://github.com/Dosugamea/voicevox-mcp-server.git
cd voicevox-mcp-server

2. 安裝依賴項

npm install

3. 配置環境變量 將 .env_example 複製為 .env 文件並按需修改：

VOICEVOX_API_URL=http://localhost:50021
VOICEVOX_SPEAKER_ID=1

運行方法

Windows 環境運行

在編輯器和其他窗口中分別執行以下命令啟動服務器：

npm run build
npm start

Docker 環境運行

無需在編輯器中操作，直接運行即可。由於是 stdio 模式，無法直接啟動。

配置方法

Windows 環境運行時

在 mcp.json 中添加以下內容：

        "voicevox": {
            "url": "http://localhost:10100/sse"
        }

若連接不穩定可考慮重新連接。

Docker 環境運行時

在 mcp.json 中添加以下內容（作者環境未驗證）：

{
    "tools": {
        "voicevox": {
            "command": "cmd",
            "args": [
                "/c",
                "docker",
                "run",
                "-i",
                "--rm",
                "-v",
                "/mnt/wslg:/mnt/wslg",
                "-e",
                "PULSE_SERVER=unix:/tmp/pulseaudio.sock",
                "-e",
                "QT_QPA_PLATFORM=offscreen",
                "dosugamea/voicevox",
                "python3",
                "main.py"
            ],
            "env": {
                "LD_LIBRARY_PATH": "/usr/lib:/$LD_LIBRARY_PATH",
                "PULSE_SERVER": "unix:/tmp/pulseaudio.sock",
                "QT_QPA_PLATFORM": "offscreen"
            }
        }
    }
}

✨ 主要特性

關於說話人 ID

• VOICEVOX_SPEAKER_ID=1 對應的是“Yuki”角色
• 其他 ID 對應的角色請參考 https://voicevox.ai/speaker/

🔧 技術細節

故障排除

與 Voicevox 的連接錯誤

• 確保 Voicevox 已正確安裝並運行，特別是 Wails 應用版本需為 v3.0.0 或更高
• 檢查是否有其他進程佔用相關端口

打包失敗

• 安裝 .NET SDK：dotnet install sdk
• 確保 Node 版本正確：使用 nvm use 16

在 Docker 中無法啟動 Voicevox

• 確保 Docker 正確安裝且正在運行
• 檢查是否有其他進程佔用相關端口
• 確保 Wails 應用版本為 v3.0.0 或更高

配置錯誤

• 查看控制檯輸出以獲取具體錯誤信息
• 可通過 npm run dev 以調試模式運行，便於發現和解決問題