VOICEVOX

🚀 Voicevox MCP サーバー

Model Context Protocol (MCP) を通じて、VOICEVOX、AivisSpeech、COEIROINK の音声合成技術を利用した相互運用可能な音声合成サーバーです。Cursor などのツールで Claude 3.7 の代理モードで音声合成を行うのに適しています。

🚀 クイックスタート

このサーバーは、VOICEVOX、AivisSpeech、COEIROINK の音声合成技術を相互運用可能にし、Cursor などのツールでの音声合成に利用できます。以下に、環境ごとのセットアップ方法を説明します。

✨ 主な機能

• Model Context Protocol (MCP) を通じた音声合成技術の相互運用
• Windows 環境と Docker 環境 (WSL2) の両方での動作サポート
• 話者 ID の変更による音声のカスタマイズ

📦 インストール

前提条件

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 に以下の内容を追加します。 接続が不安定で切断されるのを避けるため、自動再接続を有効にしてください。

        "voicevox": {
            "url": "http://localhost:10100/sse"
        }

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 の下でライセンスされています。