Voicevox Mcp
What is Voicevox Mcp
voicevox-mcp is a Model Context Protocol (MCP) server that integrates with the VOICEVOX engine to enable voice synthesis and retrieval of speaker information. It is implemented in TypeScript and utilizes the MCP SDK.
Use cases
Use cases for voicevox-mcp include creating interactive voice applications, enhancing user experience in games with voiceovers, and developing tools for accessibility that convert text to speech.
How to use
To use voicevox-mcp, set up the VOICEVOX engine using Docker, then install the necessary dependencies and build the project. Configure the MCP client to connect to the server and use the ‘speakers’ tool to retrieve speaker lists and the ‘speak’ tool to synthesize text into speech.
Key features
Key features include the ability to retrieve speaker information from the VOICEVOX engine and synthesize speech from text using a specified speaker. Currently, local playback is supported only on Mac systems.
Where to use
voicevox-mcp can be used in various fields such as game development, virtual assistants, and any application requiring voice synthesis capabilities.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Voicevox Mcp
voicevox-mcp is a Model Context Protocol (MCP) server that integrates with the VOICEVOX engine to enable voice synthesis and retrieval of speaker information. It is implemented in TypeScript and utilizes the MCP SDK.
Use cases
Use cases for voicevox-mcp include creating interactive voice applications, enhancing user experience in games with voiceovers, and developing tools for accessibility that convert text to speech.
How to use
To use voicevox-mcp, set up the VOICEVOX engine using Docker, then install the necessary dependencies and build the project. Configure the MCP client to connect to the server and use the ‘speakers’ tool to retrieve speaker lists and the ‘speak’ tool to synthesize text into speech.
Key features
Key features include the ability to retrieve speaker information from the VOICEVOX engine and synthesize speech from text using a specified speaker. Currently, local playback is supported only on Mac systems.
Where to use
voicevox-mcp can be used in various fields such as game development, virtual assistants, and any application requiring voice synthesis capabilities.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
voicevox-mcp
このプロジェクトは、VOICEVOXエンジンと連携して音声合成やスピーカー情報の取得ができるMCP（Model Context Protocol）サーバーです。TypeScriptで実装されており、MCP SDKを利用しています。
機能
- 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/sdkzodtypescript
注意事項
- 今後改善
- VOICEVOXエンジンが localhost:50021 で動作していないと音声合成は利用できません。
- Mac以外の環境では afplay の部分を適宜変更してください。
ライセンス
MIT License
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
