RVC Voice MCP

Convierte texto de un cliente de chat compatible con MCP en voz, transfórmalo con un modelo RVC local .pth + .index y muestra un reproductor de audio en la conversación.

Este proyecto genera audio sintético. Solo usa voces que poseas o para las que tengas permiso, y divulga claramente que el resultado es generado por IA.

Cómo funciona

1. ChatGPT llama a speak_rvc con texto.

2. El servidor local le pide a Applio que sintetice una voz base y ejecute la conversión RVC.

3. El widget de MCP Apps renderiza el WAV generado en un reproductor integrado.

El servidor nunca acepta rutas de modelos ni comandos de shell desde el chat. Las rutas están fijadas en la configuración local del entorno y excluidas de Git.

Requisitos

• Windows y Node.js 20+

• Una instalación funcional de Applio, ya sea dentro de local/Applio o en una ruta configurada manualmente

• Un .pth de inferencia RVC y su .index correspondiente

• Modo Desarrollador de ChatGPT y un túnel HTTPS público para la integración web

Configuración local

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

Edita .env antes de comenzar y reemplaza HTTP_TOKEN con un secreto aleatorio largo.

Descubrimiento automático local

El repositorio reserva estos directorios locales ignorados:

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

Si los cuatro ajustes de ruta en .env se dejan vacíos, el servidor usa local/Applio/env/python.exe y busca en local/models de forma recursiva. La selección automática de modelos solo se habilita cuando hay exactamente un archivo .pth y exactamente un archivo .index, evitando una coincidencia accidental cuando hay varias voces instaladas.

Las rutas manuales siguen teniendo prioridad. Puedes establecer cualquiera o todos estos valores de forma independiente:

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

Reinicia el servicio después de agregar o cambiar modelos porque el descubrimiento ocurre al inicio.

• Salud: http://127.0.0.1:8788/health

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

Endpoint público de un clic

Ejecuta:

npm run public

La primera ejecución descarga Cloudflare Tunnel en la carpeta local tools ignorada. El script genera un token de acceso nuevo, inicia el servidor MCP y el túnel en segundo plano, y luego imprime la URL del conector HTTPS para agregar en el Modo Desarrollador de ChatGPT. Mantén esa terminal abierta solo mientras lees la URL; los dos procesos en segundo plano continúan ejecutándose.

Detén ambos procesos con:

npm run stop

Los túneles rápidos están pensados para desarrollo y su URL cambia cada vez. Para una versión pública estable, configura un Cloudflare Tunnel con nombre y un dominio que controles.

Herramientas

• speak_rvc(text) genera voz de IA y renderiza el reproductor.

• get_status() verifica la configuración local sin exponer rutas.

Alcance actual

El adaptador inicial usa el comando TTS integrado de Applio y la inferencia RVC. El TTS totalmente sin conexión y un túnel con nombre estable son trabajo futuro.

Licencia

MIT