Voicevox MCP Server
About
docker版 voicevox engine を利用し受け取るメッセージを音声再生するMCP Server
Details
- Author
- srvhat09
- GitHub stars
- 2
- Downloads
- 182
- Categories
- Other
Jump to
- Converts text to speech audio queries
- Converts audio queries to WAV data
- Plays generated audio directly
- MCP‑compliant JSON‑RPC over stdio interface
- Configurable Voicevox Engine host, port, and speaker ID
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Voicevox MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies with uv sync, start the Voicevox Engine via Docker, then configure the server in your MCP client (e.g., Cline, Roo code) using the provided JSON settings. The server runs as a stdio-based MCP tool and can be invoked with synthesizeAndPlay(message="..."). Optional arguments include --host, --port, and --speaker (default speaker ID is 3).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"voicevox mcp server": {
"voicevox_mcp_light": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"voicevox_mcp_light": {
"command": "uv",
"args": [
"sync"
]
}
}Voicevox MCP Server
Model Context Protocol (MCP)に準拠したVoicevoxクライアントサーバー
概要
- このプロジェクトは、Voicevox Engineを利用して音声合成を行い、その結果を再生するMCPサーバーを提供します。CursorやClineなどのAIツールから呼び出し可能なエンドポイントを提供し、テキストを音声に変換して再生する機能を実現します。
- 注意）voicevoxのデフォルトの仕様ですが、英単語や全て英文字一字毎にアルファベットを発声します。回避するには、独自辞書を用意し登録する場合と、投入するテキストに単語をカタカナ化する方法の2通り存在します。
LLMにカタカナ語に自動変換を指示しても現時点では全ては上手くはいかないかと思います。独自辞書作成インタフェースは現時点では未実装です。
機能
- テキストから音声クエリ（Audio Query）への変換
- 音声クエリからWAVデータへの変換
- 生成した音声データの再生
- MCPプロトコルに準拠したJSON-RPC over stdioインターフェース
必要条件
- Python 3.10以上
- Voicevox Engine（ローカルまたはリモートで実行中）
- 必要なPythonパッケージ（requirements.txtを参照）
インストール
1. リポジトリをクローン
git clone https://github.com/yourusername/voicevox-mcp-vc1.git
cd voicevox-mcp-vc1
2. 依存関係のインストール
uv sync
3. Voicevox Engineの起動
# CPU版 Dockerを使用する場合
docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest
# GPU版 Dockerを使用する場合
docker pull voicevox/voicevox_engine:nvidia-latest
docker run --rm --gpus all -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:nvidia-latest
使用方法
CLINE / Roo code
- デフォルト起動の場合（http://127.0.0.1:50021 spaker id:1）{
"mcpServers": {
"voicevox-mcp-light": {
"disabled": false,
"command": "uv",
"args": [
"run",
"--directory",
"/full path/voicevox_mcp_light/",
"python",
"-m",
"src.main"
],
"transportType": "stdio",
"alwaysAllow": [],
"env": {
"PULSE_SERVER": "/run/user/1000/pulse/native"
}
}
}
}
"voicevox-mcp-light": {
"disabled": false,
"command": "/full path/uv",
"args": [
"run",
"--directory",
"/full path/voicevox_mcp_light/",
"python",
"-m",
"src.main",
"--speaker",
"8"
],
"transportType": "stdio",
"alwaysAllow": [],
"env": {
"PULSE_SERVER": "/run/user/1000/pulse/native"
}
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
