Voicevox MCP Server

Voicevox MCP Server是一個VOICEVOX兼容的語音合成服務器，通過MCP協議實現與AivisSpeech/VOICEVOX/COEIROINK的交互，支持Cursor等編輯器中的Claude 3.7代理模式語音合成。

語音處理開發者工具 #語音合成 #VOICEVOX #MCP協議 #AI代理 .TypeScript

評分 : 2.5分

下載量 : 13

更新時間 : 2025-04-28

什麼是Voicevox MCP Server?

這是一個將VOICEVOX/AivisSpeech/COEIROINK等語音合成引擎通過MCP協議暴露的服務，允許開發者在Cursor等編輯器中實現AI語音交互功能。

如何使用Voicevox MCP Server?

通過簡單的HTTP接口或Docker容器即可接入，支持Windows和WSL2環境，可與本地VOICEVOX引擎無縫集成。

適用場景

適用於需要語音交互的AI開發場景，如： - 編輯器智能助手語音反饋 - 交互式語音應用原型開發 - 多模態AI應用集成

主要功能

多引擎支持兼容VOICEVOX/AivisSpeech/COEIROINK等多種語音合成引擎

跨平臺運行支持Windows原生環境和WSL2 Docker容器部署

MCP協議集成通過標準MCP協議與編輯器/IDE深度集成

優勢與侷限性

優勢

開箱即用的語音合成解決方案

無需複雜配置即可接入現有VOICEVOX環境

支持Docker容器化部署

侷限性

目前僅支持日語語音合成

Windows環境需要預裝VLC播放器

Docker環境音頻配置較複雜

如何使用

環境準備

安裝Node.js 18+和VOICEVOX ENGINE，確保VLC播放器已安裝並配置PATH

克隆倉庫

獲取最新版本的服務器代碼

配置環境

複製.env_example為.env並設置VOICEVOX API地址和說話人ID

啟動服務器

編譯並運行服務器

使用案例

編輯器集成在Cursor編輯器中配置mcp.json實現AI語音反饋

自定義說話人通過環境變量切換不同語音風格

常見問題

如何確認VOICEVOX引擎已正確連接？

Docker環境下沒有聲音怎麼辦？

可以同時使用多個語音引擎嗎？

🚀 語音合成服務器 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 有訪問權限

安裝與配置

克隆代碼庫

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

安裝依賴項

npm install

配置環境變量將 .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"
            }
        }
    }
}