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 へのアクセス権限

Related MCP server: AivisSpeech MCP Server

インストールと設定

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

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

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

実行方法

Windows環境での実行

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

Docker環境での実行

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

設定方法

Windows環境での実行の場合

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

Docker環境での実行の場合

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

話者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