MCP 服务器

Voicevox MCP Server

一个服务器，使 Claude 3.7 和其他 AI 代理能够通过模型上下文协议访问兼容 VOICEVOX 的语音合成引擎（AivisSpeech、VOICEVOX、COEIROINK）。

README

Voicevox MCP 服务器

这是一个兼容 VOICEVOX 的语音合成服务器，它通过 MCP (Model Context Protocol) 来使用 AivisSpeech / VOICEVOX / COEIROINK。可用于 Cursor 等工具中，在 Claude 3.7 的代理模式下进行语音合成。

必要条件

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 的访问权限

安装和配置

克隆仓库

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",
                "-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"
            }
        }
    }
}