RVC Voice MCP

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

本项目生成合成音频。请仅使用您拥有或获得许可的声音，并明确披露 AI 生成的内容。

工作原理

1. ChatGPT 调用 speak_rvc 并传入文本。

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

3. MCP Apps 组件在行内播放器中渲染生成的 WAV 文件。

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

环境要求

• 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

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

• 健康检查：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 服务器和隧道，然后打印 HTTPS 连接器 URL，供您在 ChatGPT 开发者模式中添加。仅在读取 URL 期间保持该终端窗口打开；两个后台进程会继续运行。

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

npm run stop

快速隧道仅用于开发，其 URL 每次都会变化。如需稳定的公共发布，请配置一个命名的 Cloudflare Tunnel 以及您控制的域名。

工具

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

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

当前范围

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

许可证

MIT