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 进行许可。