Skip to main content
Glama

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 デスクトップアプリ を起動しておく(推奨・最も簡単)

  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"
      }
    }
  }
}

🛠️ 提供ツール一覧

ツール名

説明

主なパラメータ

voicevox_status

エンジンの稼働確認・バージョン取得

なし

voicevox_get_speakers

利用可能な話者(キャラクター)・スタイル一覧取得

singersOnly (boolean)

voicevox_speak

テキストから音声WAVを生成・保存・再生

text, speaker (ID), outputPath, play, speedScale 等

voicevox_create_song_project

楽譜データから .vvproj を生成(GUIで調声可能)

outputPath, notes, bpm, styleId, trackName

voicevox_sing

楽譜データから歌声WAVを合成・レンダリング

notes, styleId, bpm, outputPath, play

voicevox_play_audio

既存の音声ファイル(WAV/MP3)をPCで再生

filePath

voicevox_get_character_info

キャラクター利用規約・クレジット表記例の取得

characterName


🎼 歌声プロジェクト(.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 のもとで公開されています。

Available Tools

7 tools
voicevox_create_song_projectA

Create a VOICEVOX Song project file (.vvproj) from note events, lyrics, and tempo. Can be opened directly in the VOICEVOX GUI for fine-tuning.

Inputs: notes (required), outputPath (required), bpm, styleId, +1 more.

voicevox_get_character_infoA

Get credit notation templates and character licensing guidelines for VOICEVOX characters (e.g. ずんだもん, 四国めたん).

Inputs: characterName.

voicevox_get_speakersB

Get the list of available characters (speakers) and styles, including their speaker IDs.

Inputs: singersOnly.

voicevox_play_audioA

Play an existing audio file (WAV or MP3) through system speakers.

Inputs: filePath (required).

voicevox_singB

Synthesize singing audio directly from musical notes using VOICEVOX Song/Frame synthesis or audio queries, outputting a WAV file.

Inputs: notes (required), outputPath (required), bpm, play, +1 more.

voicevox_speakB

Synthesize speech from Japanese text using VOICEVOX and save to a WAV file, with optional playback.

Inputs: text (required), play, speaker, outputPath, +4 more.

voicevox_statusA

Check the status and version of the local VOICEVOX Engine (default: http://127.0.0.1:50021).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation4/5

    All tools share the voicevox_ prefix and mostly follow a verb_noun pattern (get_speakers, play_audio, create_song_project, get_character_info). Two outliers—voicevox_status (noun only) and voicevox_speak/voicevox_sing (bare verbs)—keep it from being fully uniform.

    Naming Consistency4/5

    All tools share the voicevox_ prefix and mostly follow a verb_noun pattern (get_speakers, play_audio, create_song_project, get_character_info). Two outliers—voicevox_status (noun only) and voicevox_speak/voicevox_sing (bare verbs)—keep it from being fully uniform.

    Tool Count5/5

    Seven tools is well within the ideal range and each one covers a distinct step of the VOICEVOX workflow (check engine, inspect speakers, synthesize speech, synthesize song, play audio, get credit info). Nothing feels redundant or padded.

    Completeness4/5

    The surface covers engine status, voice discovery, speech and singing synthesis, project file generation, playback, and licensing attribution—a coherent end-to-end workflow. Minor gaps remain, such as stopping an active playback, enumerating audio output devices, or deleting/managing generated files, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers