Voicevox MCP Server
2025.03.24
3
TypeScript语音合成VOICEVOX 兼容内容生成
Voicevox MCP Server 是一个通过 MCP (Model Context Protocol) 提供 VOICEVOX 兼容的语音合成服务的服务器。它支持 AivisSpeech、VOICEVOX 和 COEIROINK 等语音合成引擎，适用于在 Cursor 等编辑器中使用 Claude 3.7 的代理模式进行语音合成。
View on GitHub
Overview
基本能力
产品定位
Voicevox MCP Server 是一个语音合成服务器，通过 MCP 协议提供 VOICEVOX 兼容的语音合成服务。
核心功能
- 支持 VOICEVOX、AivisSpeech 和 COEIROINK 等语音合成引擎。
- 通过 MCP 协议提供语音合成服务。
- 支持在 Cursor 等编辑器中使用 Claude 3.7 的代理模式进行语音合成。
适用场景
- 在编辑器中进行语音合成。
- 代理模式下的语音合成应用。
工具列表
- VLC 媒体播放器：用于语音播放。
- Node.js：运行服务器。
- Docker：在 Docker 环境中运行服务器。
常见问题解答
- VOICEVOX 连接错误：检查 VOICEVOX ENGINE 是否运行，API URL 是否正确。
- 语音无法播放：检查 VLC 是否安装且路径正确。
- Docker 环境中的音频输出问题：检查 pulseaudio 配置是否正确。
使用教程
使用依赖
Windows 环境
- Node.js 18 以上
- VOICEVOX ENGINE（本地运行于 http://localhost:50000）
- VLC 媒体播放器（需配置路径）
Docker 环境 (WSL2)
- Docker 和 Docker Compose
- WSL2
- VOICEVOX ENGINE（本地或 Docker 中运行）
- 安装依赖库：
bash sudo apt install libsdl2-dev pulseaudio-utils pulseaudio /mnt/wslg访问权限
安装教程
- 克隆仓库：
bash git clone https://github.com/Dosugamea/voicevox-mcp-server.git cd voicevox-mcp-server - 安装依赖：
bash npm install - 配置环境变量：
- 复制
.env_example为.env并修改配置：VOICEVOX_API_URL=http://localhost:50021 VOICEVOX_SPEAKER_ID=1
调试方式
Windows 环境
npm run build
npm start
Docker 环境
无需单独操作，服务器以 stdio 模式运行。