快速入门

前置条件

• 安装 Node.js 18 或更高版本
• 启动 VOICEVOX ENGINE（默认运行在 http://localhost:50021）
• 安装 VLC 媒体播放器（Windows）或配置 pulseaudio（Docker）

安装与配置

1. 克隆代码库：git clone https://github.com/Dosugamea/voicevox-mcp-server.git
2. 进入项目目录：cd voicevox-mcp-server
3. 安装依赖：npm install
4. 配置环境变量：复制 .env_example 为 .env 并根据需要修改内容，例如：
   • VOICEVOX_API_URL=http://localhost:50021
   • VOICEVOX_SPEAKER_ID=1

启动服务

• 在 Windows 上执行：
  1. 构建项目：npm run build
  2. 启动服务：npm start
• 在 Docker 中运行时，请参考 README 的 Docker 部分。

测试配置

确保 mcp.json 文件中已正确配置 Voicevox 的 URL，例如：

"voicevox": {
    "url": "http://localhost:10100/sse"
}

常见问题

• 无法连接到 VOICEVOX：检查 API 地址和端口是否正确。
• 没有声音输出：确认 VLC 正常安装并配置正确。