voicevox-mcp

voicevox-mcp

1
entertainment_and_media

The voicevox-mcp project provides a Model Context Protocol (MCP) server that integrates with the VOICEVOX engine for speech synthesis and speaker information retrieval. It's implemented in TypeScript and supports local speech playback, primarily on Mac systems.

voicevox-mcp

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

VOICEVOX Server MCP server

機能

  • 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