voicevox-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@voicevox-mcp ずんだもんの声で「こんにちは」と音声を作って再生して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)が稼働している必要があります。
VOICEVOX デスクトップアプリ を起動しておく(推奨・最も簡単)
VOICEVOX 公式サイト よりダウンロードして起動
または、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"
}
}
}
}🛠️ 提供ツール一覧
ツール名 | 説明 | 主なパラメータ |
| エンジンの稼働確認・バージョン取得 | なし |
| 利用可能な話者(キャラクター)・スタイル一覧取得 |
|
| テキストから音声WAVを生成・保存・再生 |
|
| 楽譜データから |
|
| 楽譜データから歌声WAVを合成・レンダリング |
|
| 既存の音声ファイル(WAV/MP3)をPCで再生 |
|
| キャラクター利用規約・クレジット表記例の取得 |
|
🎼 歌声プロジェクト(.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 toolsvoicevox_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Use VoiceCheap’s media tools from your AI agent: transcribe audio, video and YouTube; create, translate and add subtitles to videos; generate YouTube chapters; create speech, design voices or clone voices with permission; generate images and thumbnails; translate and dub videos with optional lip sync; and publish completed projects to your connected channels. Manage project status, transcripts, glossaries and workspace settings through the tools you authorize. Available tools depend on your OAuth permissions and account access. Generation uses existing credits; purchases take place on the VoiceCheap website.
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
Audio for your agent: transcribe, speak, translate, summarise, plus sound effects and music.
Manage ElevenLabs voice agents and generate speech, music, sound effects, images, and video.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to generate and play high-quality text-to-speech audio using the Kokoro model, with support for multiple voices, adjustable speaking speed, and audio caching.-
- AlicenseAqualityDmaintenanceEnables Claude Desktop and Claude Code to synthesize and play speech using VOICEVOX text-to-speech engine. Supports multiple voice characters, session-based voice assignment, and queue management for audio playback.772 npmMIT
- AlicenseAqualityNot gradedmaintenanceEnables integration with VOICEVOX text-to-speech services to convert text into audio using a variety of character voices. It provides tools for speech generation, listing available speakers, and monitoring system health.5-

@vocea.app/mcp-serverofficial
AlicenseAqualityCmaintenanceEnables AI agents to generate speech, transcribe audio, and manage voices via the Vocea API.6MIT