Voicevox MCP

🚀 voicevox - mcp

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

🚀 クイックスタート

このプロジェクトは、VOICEVOXエンジンと連携したMCPサーバーです。以下の手順でセットアップし、使用することができます。

✨ 主な機能

• 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