Voicevox MCP Server

兼容VOICEVOX的声音合成服务器MCP（模型上下文协议）服务器，通过Cursor等Claude 3.7代理模式使用。

必要条件

Windows环境

• Node.js 18及以上版本
• VOICEVOX ENGINE等（例如：在本地执行http://localhost:50000）
• VLC媒体播放器

Docker环境（WSL2）

• Docker 和 Docker Compose
• WSL2
• 在Docker中运行的VOICEVOX ENGINE等
• 在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",
                "-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:5_0031",
                "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。
• 报告Bug或提出功能请求，请使用GitHub的Issue功能。

许可证

MIT许可证