voicevox-mcp

VOICEVOX の音声合成（TTS）・歌声合成（Song）・プロジェクト生成（.vvproj）を、AIエージェント（Google Antigravity, Claude Desktop, Cursor, Cline 等）から直感的に操作できる Model Context Protocol (MCP) サーバーです。

🌟 特徴

• テキスト音声合成 (TTS):

  • ずんだもん、四国めたん、春日部つむぎ等の多彩なキャラクターによる日本語音声（WAV）の自動生成

  • 話速、音高、抑揚、音量の自由なコントロール

  • 生成した音声の即時PCスピーカー再生（Windows / macOS / Linux 対応）

• ソング・歌唱生成 (Song):

  • 楽譜データ（音符番号・長さ・歌詞）から歌声合成

  • VOICEVOX GUI で直接開いて微調整できる .vvproj（プロジェクトファイル）の自動出力

• 依存パッケージゼロ:

  • Node.js 標準ライブラリのみで実装されており、npm install 不要で軽量・即座に稼働

• ライセンス・クレジット支援:

  • 各キャラクターの利用規約や必須クレジット表記の確認ツールを標準搭載

Related MCP server: VOICEVOX MCP Server

📋 前提条件

ローカル環境で VOICEVOX Engine（ポート 50021）が稼働している必要があります。

1. VOICEVOX デスクトップアプリ を起動しておく（推奨・最も簡単）

   • VOICEVOX 公式サイト よりダウンロードして起動

2. または、Docker / コンテナ版 を起動する

   docker run --rm -p 50021:50021 voicevox/voicevox_engine:cpu-ubuntu20.04-latest

⚙️ MCP クライアントへの導入設定

1. Antigravity の場合

%USERPROFILE%\.gemini\config\mcp_config.json に以下を追記します。

{
  "mcpServers": {
    "voicevox": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "E:\\Project\\voicevox-mcp\\run-server.cmd"
      ],
      "env": {
        "VOICEVOX_ENGINE_URL": "http://127.0.0.1:50021"
      }
    }
  }
}

2. Claude Desktop の場合

%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）に以下を追記します。

{
  "mcpServers": {
    "voicevox": {
      "command": "node",
      "args": [
        "E:/Project/voicevox-mcp/server.js"
      ],
      "env": {
        "VOICEVOX_ENGINE_URL": "http://127.0.0.1:50021"
      }
    }
  }
}

🛠️ 提供ツール一覧

🎼 歌声プロジェクト（.vvproj）生成の例

AIエージェントに「このメロディと歌詞でソングプロジェクトを作って」と指示すると、以下のような形式で .vvproj が生成されます。

{
  "outputPath": "E:/Music/my_song.vvproj",
  "bpm": 150,
  "styleId": 6000,
  "notes": [
    { "position": 0, "duration": 480, "noteNumber": 60, "lyric": "ど" },
    { "position": 480, "duration": 480, "noteNumber": 62, "lyric": "れ" },
    { "position": 960, "duration": 480, "noteNumber": 64, "lyric": "み" }
  ]
}

生成されたファイルを VOICEVOX アプリの「ソング」機能で開くだけで、ピアノロール上で発音・音程・ビブラートなどを自由に微調整してWAV書き出しが可能です。

📜 商標・権利表記・免責事項について

免責事項 (Disclaimer)

• 本ツール（voicevox-mcp）は、VOICEVOX Engine と各種 AI エージェントを連携させるための非公式（サードパーティ製）MCPサーバーです。

• VOICEVOX 開発者（ヒホ氏）および公式 VOICEVOX プロジェクトとは直接の関係はありません。

商標・著作権について

• 「VOICEVOX」の名称、ソフトウェア、およびロゴの著作権・権利は ヒホ（hiroshiba）氏 に帰属します。

• 各キャラクター（ずんだもん、四国めたん、春日部つむぎ等）の音声ライブラリおよびキャラクター画像の著作権・権利は、それぞれの権利者（SSS合同会社等）に帰属します。

生成した音声の利用規約・クレジット表記

VOICEVOX で生成した音声を作品・動画・ゲーム・配信等で公開・利用する際は、キャラクターごとの利用規約を遵守し、クレジット表記を行う必要があります。

クレジット表記の例:

• VOICEVOX:ずんだもん

• VOICEVOX:四国めたん

• VOICEVOX:波音リツ

各キャラクターの詳細な利用規約については、本サーバーの voicevox_get_character_info ツール、または VOICEVOX 公式サイト をご確認ください。

📄 ライセンス

本リポジトリのソースコードは MIT License のもとで公開されています。