VOICEVOX

🚀 Voicevox MCP 服務器

Voicevox MCP 服務器是一個具備互操作性的語音合成服務器，它藉助 Model Context Protocol (MCP) 技術，能夠利用 VOICEVOX、AivisSpeech、COEIROINK 的語音合成能力。該服務器尤其適用於像 Cursor 這類工具，在使用 Claude 3.7 的代理模式時進行語音合成。

🚀 快速開始

在使用 Voicevox MCP 服務器之前，需要根據不同的環境完成相應的準備工作。

✨ 主要特性

• 支持多種語音合成技術，包括 VOICEVOX、AivisSpeech、COEIROINK。
• 適用於 Cursor 等工具在 Claude 3.7 代理模式下的語音合成。
• 提供 Windows 和 Docker 兩種環境的部署方式。

📦 安裝指南

先決條件

Windows 環境

• Node.js 18 或更高版本。
• VOICEVOX ENGINE（需在 http://localhost:50000 等本地地址運行）。
• VLC 媒體播放器（已完成路徑配置）。

Docker 環境 (WSL2)

• Docker 和 Docker Compose。
• WSL2。
• VOICEVOX ENGINE（可在本地或 Docker 中運行）。
• 已安裝 sudo apt install libsdl2-dev pulseaudio-utils pulseaudio 的 Linux 環境。
• 具備對 /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",
                "-e",
                "SDL_AUDIODRIVER",
                "-e",
                "VOICEVOX_API_URL",
                "-e",
                "VOICEVOX_SPEAKER_ID",
                "your-local-docker-image-name"
            ],
            "env": {
                "PULSE_SERVER": "unix:/mnt/wslg/PulseServer",
                "SDL_AUDIODRIVER": "pulseaudio",
                "VOICEVOX_API_URL": "http://host.docker.internal:50031",
                "VOICEVOX_SPEAKER_ID": "919692871"
            }
        }
    }
}

📚 詳細文檔

話者 ID

話者 ID 根據所使用的 VOICEVOX 模型而有所不同。默認使用「1」（四國めたん）。如需使用其他話者 ID，請修改環境變量 VOICEVOX_SPEAKER_ID。 話者 ID 的列表可通過 VOICEVOX ENGINE API 的 /speakers 端點進行確認。 例如: curl http://localhost:50021/speakers

問題排除

• VOICEVOX 連接錯誤：請確認 VOICEVOX ENGINE 已啟動，且 API URL 配置正確。
• 音頻未播放：請確認 VLC 已正確安裝並配置了路徑。
• Docker 環境下的音頻輸出問題：請檢查 pulseaudio 的設置是否正確。

開發者信息

• 如需貢獻代碼，請創建 Issue 或提交 Pull Request。
• 有關錯誤報告或功能請求，請使用 GitHub 的 Issue 功能。

📄 許可證

本項目採用 MIT License 進行許可。