Provides Docker Compose setup for easily running the required VOICEVOX engine locally.
The MCP server is implemented in TypeScript for type safety and developer experience.
Uses Zod for runtime schema validation within the MCP server implementation.
voicevox-mcp
このプロジェクトは、VOICEVOXエンジンと連携して音声合成やスピーカー情報の取得ができるMCP(Model Context Protocol)サーバーです。TypeScriptで実装されており、MCP SDKを利用しています。
機能
VOICEVOXエンジンのスピーカー情報取得(/speakers)
指定したスピーカーでテキストを音声合成し、ローカルで再生(/speak)
Macのみ対応
セットアップ
VOICEVOXエンジンの起動(Docker推奨)
これで localhost:50021 でVOICEVOXエンジンが起動します。
Related MCP server: TTS-MCP
依存パッケージのインストール & ビルド
使い方
Cursorの設定例
VOICEVOX_API_URLは必要に応じて設定
MCPクライアントから speakers ツールでスピーカー一覧を取得できます。
speak ツールでテキストを音声合成し、ローカルで再生できます(afplayコマンドを使用しているため、Mac環境推奨)。
主な依存パッケージ
@modelcontextprotocol/sdkzodtypescript
注意事項
今後改善
VOICEVOXエンジンが localhost:50021 で動作していないと音声合成は利用できません。
Mac以外の環境では afplay の部分を適宜変更してください。
ライセンス
MIT License