RVC Voice MCP

MCP를 지원하는 채팅 클라이언트의 텍스트를 음성으로 만들고, 로컬 RVC .pth + .index 모델로 변환한 다음, 대화에서 오디오 플레이어를 렌더링합니다.

이 프로젝트는 합성 오디오를 생성합니다. 소유했거나 사용 권한이 있는 목소리만 사용하고, AI 생성 출력임을 명확히 공개하세요.

작동 방식

1. ChatGPT가 텍스트와 함께 speak_rvc를 호출합니다.

2. 로컬 서버는 Applio에 기본 음성 합성 및 RVC 변환 실행을 요청합니다.

3. MCP Apps 위젯이 생성된 WAV를 인라인 플레이어에 렌더링합니다.

서버는 채팅에서 모델 경로나 셸 명령을 절대 수락하지 않습니다. 경로는 로컬 환경 구성에 고정되며 Git에서 제외됩니다.

요구 사항

• Windows 및 Node.js 20+

• local/Applio 내부 또는 수동으로 구성된 경로에 설치된 작동하는 Applio

• RVC 추론용 .pth 및 일치하는 .index

• 웹 통합을 위한 ChatGPT Developer Mode 및 공개 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 서버와 터널을 백그라운드에서 시작한 다음, ChatGPT Developer Mode에 추가할 HTTPS 커넥터 URL을 출력합니다. URL을 읽는 동안에만 해당 터미널을 열어 두세요. 두 백그라운드 프로세스는 계속 실행됩니다.

다음 명령으로 두 프로세스를 모두 중지하세요:

npm run stop

Quick Tunnel은 개발용으로 설계되었으며 URL이 매번 변경됩니다. 안정적인 공개 릴리스의 경우 명명된 Cloudflare Tunnel과 직접 관리하는 도메인을 구성하세요.

도구

• speak_rvc(text)는 AI 음성을 생성하고 플레이어를 렌더링합니다.

• get_status()는 경로를 노출하지 않고 로컬 구성을 확인합니다.

현재 범위

초기 어댑터는 Applio의 내장 TTS 명령과 RVC 추론을 사용합니다. 완전한 오프라인 TTS와 안정적인 명명된 터널은 향후 작업입니다.

라이선스

MIT