RVC Voice MCP

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

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

작동 방식

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

2. 로컬 서버가 Applio에 기본 음성 합성과 RVC 변환을 요청합니다.

3. PLAYBACK_MODE에 따라 로컬 컴퓨터가 WAV를 재생하거나, MCP Apps 위젯이 렌더링하거나, 둘 다 수행됩니다.

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

Related MCP server: MCP TTS Server

요구 사항

• 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

검색은 시작 시 수행되므로 모델을 추가하거나 변경한 후 서비스를 다시 시작하세요.

재생 모드

생성된 음성이 재생될 위치를 선택하세요:

PLAYBACK_MODE=widget

• widget은 ChatGPT 오디오 카드를 통해 재생합니다.

• local은 이 서버를 실행하는 컴퓨터를 통해 재생을 시작합니다.

• both는 로컬 재생을 활성화하고 ChatGPT 플레이어를 계속 사용할 수 있게 합니다.

Windows에서 로컬 재생은 추가 종속성 없이 작동합니다. 대신 ffplay를 사용하려면 전체 경로를 설정하세요:

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

• Health: 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 터널은 개발용으로 설계되었으며 URL이 매번 변경됩니다. 안정적인 공개 릴리스의 경우 명명된 Cloudflare Tunnel과 직접 제어하는 도메인을 구성하세요.

도구

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

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

현재 범위

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

라이선스

MIT