RVC Voice MCP

将来自支持 MCP 的聊天客户端的文本转换为语音，使用本地 RVC .pth + .index 模型进行转换，并在对话中渲染音频播放器。

本项目生成合成音频。请仅使用您拥有或有权使用的语音，并明确披露 AI 生成的内容。

工作原理

1. ChatGPT 使用文本调用 speak_rvc。

2. 本地服务器请求 Applio 合成基础语音并运行 RVC 转换。

3. 根据 PLAYBACK_MODE，本地计算机播放 WAV、MCP Apps 小部件渲染它，或两者同时进行。

服务器从不接受来自聊天的模型路径或 shell 命令。路径在本地环境配置中固定，并从 Git 中排除。

Related MCP server: MCP TTS Server

要求

• Windows 和 Node.js 20+

• 可用的 Applio 安装，位于 local/Applio 内或手动配置的路径

• RVC 推理 .pth 和匹配的 .index

• 用于 Web 集成的 ChatGPT 开发者模式和公共 HTTPS 隧道

本地设置

Copy-Item .env.example .env
npm install
npm run check
npm start

启动前编辑 .env，并将 HTTP_TOKEN 替换为长随机密钥。

本地自动发现

仓库保留以下被忽略的本地目录：

local/Applio/    Complete Applio installation
local/models/    RVC .pth and .index files

如果 .env 中的四个路径设置留空，服务器将使用 local/Applio/env/python.exe 并递归搜索 local/models。仅当恰好存在一个 .pth 和一个 .index 文件时，才会启用自动模型选择，以防止安装多个语音时发生意外不匹配。

手动路径仍然优先。您可以独立设置这些值中的任意一个或全部：

APPLIO_DIR=D:\Apps\Applio
PYTHON_PATH=D:\Apps\Applio\env\python.exe
RVC_MODEL_PATH=D:\Voices\character.pth
RVC_INDEX_PATH=D:\Voices\character.index

添加或更改模型后请重启服务，因为发现过程在启动时进行。

播放模式

选择生成语音的播放位置：

PLAYBACK_MODE=widget

• widget 通过 ChatGPT 音频卡片播放。

• local 通过运行此服务器的计算机开始播放。

• both 启用本地播放并保持 ChatGPT 播放器可用。

在 Windows 上，本地播放无需其他依赖即可工作。要改用 ffplay，请设置其完整路径：

LOCAL_PLAYER_PATH=C:\ffmpeg\bin\ffplay.exe

• 健康检查：http://127.0.0.1:8788/health

• MCP：http://127.0.0.1:8788/mcp?token=YOUR_TOKEN

一键公共端点

运行：

npm run public

首次运行会将 Cloudflare Tunnel 下载到被忽略的本地 tools 文件夹中。脚本会生成新的访问令牌，在后台启动 MCP 服务器和隧道，然后打印要在 ChatGPT 开发者模式中添加的 HTTPS 连接器 URL。仅在读取 URL 时保持该终端打开；两个后台进程会继续运行。

使用以下命令停止两个进程：

npm run stop

快速隧道仅用于开发，其 URL 每次都会变化。对于稳定的公开发布，请配置命名 Cloudflare Tunnel 和您控制的域名。

工具

• speak_rvc(text) 生成 AI 语音并渲染播放器。

• get_status() 检查本地配置而不暴露路径。

当前范围

初始适配器使用 Applio 的内置 TTS 命令和 RVC 推理。完全离线的 TTS 和稳定的命名隧道是未来的工作。

许可证

MIT