What is Voicevox Mcp Server

voicevox-mcp-server is a server that allows users to utilize VOICEVOX-compatible speech synthesis engines (such as AivisSpeech, VOICEVOX, and COEIROINK) via the Model Context Protocol (MCP). It can be used for voice synthesis in agent mode with Claude 3.7.

Use cases

Use cases for voicevox-mcp-server include creating interactive voice applications, enhancing user experience in games with dynamic voice synthesis, and developing virtual agents that require natural-sounding speech.

How to use

To use voicevox-mcp-server, clone the repository, install dependencies using npm, set up environment variables in a .env file, and then run the server using npm commands. It can be run in both Windows and Docker environments.

Key features

Key features of voicevox-mcp-server include compatibility with various VOICEVOX engines, support for both Windows and Docker environments, and the ability to configure voice synthesis settings through a JSON configuration file.

Where to use

voicevox-mcp-server can be used in fields such as game development, virtual assistants, and any application requiring text-to-speech capabilities, particularly where VOICEVOX engines are preferred.

Voicevox MCP Server

VOICEVOX互換の音声合成サーバー(AivisSpeech / VOICEVOX / COEIROINK) を MCP (Model Context Protocol) 経由で利用するためのサーバーです。
Cursor等でのClaude 3.7を使ったエージェントモードでの音声合成に利用できます。

必要条件

Windows環境

• Node.js 18以上
• VOICEVOX ENGINE等 (ローカルでhttp://localhost:50000等で実行)
• VLCメディアプレーヤー（パスが通っていること）

Docker環境 (WSL2)

• Docker と Docker Compose
• WSL2
• VOICEVOX ENGINE等 (ローカルまたはDockerで実行)
• sudo apt install libsdl2-dev pulseaudio-utils pulseaudio されたLinux環境
• /mnt/wslg へのアクセス権限

インストールと設定

1. リポジトリをクローン

git clone https://github.com/Dosugamea/voicevox-mcp-server.git
cd voicevox-mcp-server

2. 依存関係のインストール

npm install

3. 環境変数の設定
   .env_example をコピーして .env ファイルを作成し、必要に応じて設定を変更します:

VOICEVOX_API_URL=http://localhost:50021
VOICEVOX_SPEAKER_ID=1

実行方法

Windows環境での実行

エディタと別途で下記手順でサーバーを立ち上げてください。

npm run build
npm start

Docker環境での実行

エディタと別途での操作は不要です。
stdioモードで立ち上がるため直接実行することはできません。

設定方法

Windows環境での実行の場合

mcp.jsonに下記を追記してください。
接続が不安定なため切断されたら再接続してください。

Docker環境での実行の場合

mcp.jsonに下記を追記してください。
(作者環境での動作は確認できていません)

{
  "tools": {
    "voicevox": {
      "command": "cmd",
      "args": [
        "/c",
        "docker",
        "run",
        "-i",
        "--rm",
        "-v",
        "/mnt/wslg:/mnt/wslg",
        "-e",
        "PULSE_SERVER",
        "-e",
        "SDL_AUDIODRIVER",
        "-e",
        "VOICEVOX_API_URL",
        "-e",
        "VOICEVOX_SPEAKER_ID",
        "your-local-docker-image-name"
      ],
      "env": {
        "PULSE_SERVER": "unix:/mnt/wslg/PulseServer",
        "SDL_AUDIODRIVER": "pulseaudio",
        "VOICEVOX_API_URL": "http://host.docker.internal:50031",
        "VOICEVOX_SPEAKER_ID": "919692871"
      }
    }
  }
}

話者IDについて

話者IDは使用するVOICEVOXのモデルによって異なります。デフォルトでは「1」（四国めたん）を使用しています。
他の話者IDを使用する場合は、環境変数 VOICEVOX_SPEAKER_ID を変更してください。

話者IDの一覧は、VOICEVOX ENGINE APIの /speakers エンドポイントで確認できます。
例: curl http://localhost:50021/speakers

トラブルシューティング

• VOICEVOXとの接続エラー: VOICEVOX ENGINEが起動していること、APIのURLが正しく設定されていることを確認してください。
• 音声が再生されない: VLCが正しくインストールされていることと、パスが通っていることを確認してください。
• Docker環境での音声出力問題: pulseaudioの設定が正しいか確認してください。

開発者向け情報

• ソースコードに貢献する場合は、Issueを作成するか、Pull Requestを送信してください。
• バグ報告や機能リクエストは、GitHubのIssue機能をご利用ください。

ライセンス

MIT License