voicevox-mcp

このプロジェクトは、VOICEVOXエンジンと連携して音声合成やスピーカー情報の取得ができるMCP（Model Context Protocol）サーバーです。TypeScriptで実装されており、MCP SDKを利用しています。

機能

VOICEVOXエンジンのスピーカー情報取得（/speakers）
指定したスピーカーでテキストを音声合成し、ローカルで再生（/speak）
- Macのみ対応

セットアップ

VOICEVOXエンジンの起動（Docker推奨）

docker compose up -d

これで 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

VOICEVOX MCP Server

README Documentation