voicevox-mcp
이 프로젝트는 VOICEVOX 엔진과 연계하여 음성 합성 및 스피커 정보를 취득할 수 있는 MCP(Model Context Protocol) 서버입니다.
기능
- VOICEVOX 엔진의 스피커 정보 획득(/speakers)
- 지정된 스피커로 텍스트를 음성 합성하고 로컬로 재생(/speak)
설정
VOICEVOX 엔진 시작(Docker 권장)
이제 localhost : 50021에서 VOICEVOX 엔진이 시작됩니다.
종속 패키지 설치 및 빌드
npm install
npm run build
사용법
커서 설정 예
{
"mcpServers": {
"voicevox-mcp": {
"command": "node",
"args": ["${Path to Repository}/dist/index.js"],
"env": {
"SPEAKER_ID": 8,
"SPEED_SCALE": 1.2,
"VOICEVOX_API_URL": "http://localhost:50021"
}
}
}
}
VOICEVOX_API_URL은 필요에 따라 설정
- MCP 클라이언트에서 speakers 도구로 스피커 목록을 검색할 수 있습니다.
- speak 툴로 텍스트를 음성 합성해, 로컬로 재생할 수 있습니다 (afplay 커멘드를 사용하고 있기 (위해)때문에, Mac 환경 추천).
주요 종속 패키지
@modelcontextprotocol/sdk
zod
typescript
주의사항
- 앞으로 개선
- VOICEVOX 엔진이 localhost : 50021에서 작동하지 않으면 음성 합성을 사용할 수 없습니다.
- Mac 이외의 환경에서는 afplay 부분을 적절하게 변경하십시오.
라이센스
MIT License