voicevox-mcp

이 프로젝트는 VOICEVOX 엔진과 연계하여 음성 합성 및 스피커 정보를 취득할 수 있는 MCP(Model Context Protocol) 서버입니다.

기능

• VOICEVOX 엔진의 스피커 정보 획득(/speakers)

• 지정된 스피커로 텍스트를 음성 합성하고 로컬로 재생(/speak)

  • Mac만 지원

설정

VOICEVOX 엔진 시작(Docker 권장)

docker compose up -d

이제 localhost : 50021에서 VOICEVOX 엔진이 시작됩니다.

Related MCP server: AivisSpeech MCP Server

종속 패키지 설치 및 빌드

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