Voicevox MCP Server

🚀 Voicevox MCP サーバー

このサーバーは、Model Context Protocol (MCP) を通じて、Voicevox、AivisSpeech、または COEIROINK を使用した音声合成を行うことができます。Cursor などのツールで Claude 3.7 の代理モードで音声合成を利用するのに適しています。

🚀 クイックスタート

必要条件

Windows 環境

• Node.js バージョン 18 以上
• インストール済みで実行中の Voicevox ENGINE（ローカルでは http://localhost:50000 でアクセス可能）
• VLC メディアプレイヤー（システムパスに追加済み）

Docker 環境 (WSL2)

• Docker と Docker Compose がインストールされていること
• WSL2 環境
• インストール済みで実行中の Voicevox ENGINE（ローカルまたは Docker 内）
• Linux システムで sudo apt install libsdl2-dev pulseaudio-utils pulseaudio がインストールされていること
• /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=unix:/tmp/pulseaudio.sock",
                "-e",
                "QT_QPA_PLATFORM=offscreen",
                "dosugamea/voicevox",
                "python3",
                "main.py"
            ],
            "env": {
                "LD_LIBRARY_PATH": "/usr/lib:/$LD_LIBRARY_PATH",
                "PULSE_SERVER": "unix:/tmp/pulseaudio.sock",
                "QT_QPA_PLATFORM": "offscreen"
            }
        }
    }
}

話者 ID について

• VOICEVOX_SPEAKER_ID=1 は「Yuki」キャラクターに対応しています。
• その他の ID に対応するキャラクターについては、https://voicevox.ai/speaker/ を参照してください。

トラブルシューティング

Voicevox との接続エラー

• Voicevox が正しくインストールされ、実行されていることを確認してください。特に、Wails アプリケーションのバージョンが v3.0.0 以上であることを確認してください。
• 関連するポートを使用している他のプロセスがないことを確認してください。

パッケージ化に失敗した場合

• .NET SDK をインストールします：dotnet install sdk
• Node バージョンが正しいことを確認します：nvm use 16 を使用します。

Docker で Voicevox を起動できない場合

• Docker が正しくインストールされ、実行されていることを確認してください。
• 関連するポートを使用している他のプロセスがないことを確認してください。
• Wails アプリケーションのバージョンが v3.0.0 以上であることを確認してください。

構成エラー

• コンソール出力を確認して、具体的なエラー情報を取得してください。
• npm run dev を使用してデバッグモードで実行することで、問題の発見と解決が容易になります。