voicevox-mcp
このプロジェクトは、VOICEVOXエンジンと連携して音声合成やスピーカー情報の取得ができるMCP(Model Context Protocol)サーバーです。TypeScriptで実装されており、MCP SDKを利用しています。
機能
- VOICEVOXエンジンのスピーカー情報取得(/speakers)
- 指定したスピーカーでテキストを音声合成し、ローカルで再生(/speak)
セットアップ
VOICEVOXエンジンの起動(Docker推奨)
これで localhost:50021 でVOICEVOXエンジンが起動します。
依存パッケージのインストール & ビルド
npm install
npm run build
使い方
Cursorの設定例
{
"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