金大哥 - VOICEVOX MCP 详情

article

README

🚀 Voicevox MCP 服务器

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 中运行）
已安装 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"
            }
        }
    }
}

📚 详细文档

话者 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。

VOICEVOX