voiceroid_daemon-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., "@voiceroid_daemon-mcp Speak 'こんにちは、今日はいい天気ですね' with speed 1.2"
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.
voiceroid_daemon-mcp
MCP (Model Context Protocol) server for VOICEROID2 text-to-speech via voiceroid_daemon.
Features
Text-to-speech generation with VOICEROID2 voices
Text-to-kana phonetic conversion
Customizable voice parameters (volume, speed, pitch, emphasis)
Audio playback support for macOS, Windows, and Linux
Basic authentication support
Related MCP server: Bouyomi-chan MCP Server
Prerequisites
Node.js 18 or higher
voiceroid_daemon running on your system
VOICEROID2 installed (for voiceroid_daemon)
Installation
# Clone the repository
git clone https://github.com/mohemohe/voiceroid_daemon-mcp.git
cd voiceroid_daemon-mcp
# Install dependencies
npm installConfiguration
Create a .env file in the project root (optional):
# voiceroid_daemon server URL (default: http://127.0.0.1:8080)
VOICEROID_DAEMON_URL=http://127.0.0.1:8080
# Basic authentication (if required)
VOICEROID_DAEMON_USERNAME=your_username
VOICEROID_DAEMON_PASSWORD=your_password
# Default voice parameters (optional)
VOICEROID_DEFAULT_VOLUME=1.0 # 0-2
VOICEROID_DEFAULT_SPEED=1.3 # 0.5-4
VOICEROID_DEFAULT_PITCH=1.0 # 0.5-2
VOICEROID_DEFAULT_EMPHASIS=1.1 # 0-2
VOICEROID_DEFAULT_PAUSE_MIDDLE=150 # 80-500
VOICEROID_DEFAULT_PAUSE_LONG=370 # 100-2000
VOICEROID_DEFAULT_PAUSE_SENTENCE=800 # 0-10000Usage
Running the MCP Server
# Run directly with tsx (no build required)
npm start
# Or for development with auto-reload
npm run devConfiguring with Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"voiceroid-daemon": {
"command": "npx",
"args": ["tsx", "/path/to/voiceroid_daemon-mcp/src/index.ts"],
"env": {
"VOICEROID_DAEMON_URL": "http://127.0.0.1:8080"
}
}
}
}Available Tools
test_connection
Test the connection to voiceroid_daemon server.
No parameters requiredconvert_text
Convert Japanese text to phonetic kana reading.
Parameters:
text(string, required): Text to convert to kana
speak_text
Generate and play speech audio from text.
Parameters:
text(string, required): Text to speakkana(string, optional): Phonetic reading in kanavolume(number, optional): Voice volume (0-2, default: 1)speed(number, optional): Speech speed (0.5-4, default: 1)pitch(number, optional): Voice pitch (0.5-2, default: 1)emphasis(number, optional): Emphasis level (0-2, default: 1)
Example Usage in Claude
Once configured, you can use the tools in Claude:
Use the test_connection tool to check if voiceroid_daemon is running.
Convert "こんにちは" to kana using the convert_text tool.
Use speak_text to say "こんにちは、今日はいい天気ですね" with speed 1.2.Troubleshooting
Connection Failed
Ensure voiceroid_daemon is running
Check the URL in your configuration
Verify firewall settings allow connections
Test with curl:
curl http://127.0.0.1:8080/
Audio Playback Issues
macOS: Uses
afplay(built-in)Windows: Uses PowerShell's
Media.SoundPlayerLinux: Requires
aplay(usually part of alsa-utils)
Authentication Errors
If voiceroid_daemon requires authentication, ensure you've set:
VOICEROID_DAEMON_USERNAMEVOICEROID_DAEMON_PASSWORD
Development
# Type checking
npm run typecheck
# Linting
npm run lint
# Run in development mode
npm run devLicense
MIT
Available Tools
3 toolsconvert_textB
Convert text to phonetic kana reading
Inputs: text (required).
speak_textC
Generate speech audio from text and play it
Inputs: text (required), kana, volume, speed, +2 more.
test_connectionB
Test connection to voiceroid_daemon server
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 3 tools
Each tool has a clearly distinct purpose with no overlap: convert_text handles phonetic conversion, speak_text handles speech generation and playback, and test_connection handles server connectivity testing. An agent can easily distinguish between these three functions.
All tools follow a consistent verb_noun pattern with snake_case naming: convert_text, speak_text, and test_connection. The naming is predictable and readable throughout the set.
Three tools is reasonable for a voiceroid daemon server, covering core text-to-speech operations and connectivity. It's slightly minimal but functional for the apparent scope, lacking only minor enhancements like configuration or status tools.
The toolset covers essential text-to-speech workflows: phonetic conversion, speech generation/playback, and server connectivity. Minor gaps exist, such as no tools for managing voice parameters, listing available voices, or controlling playback (e.g., stop/pause), but core functionality is present.
Related MCP Connectors
MCP server for Text-to-Speech
Hosted text-to-speech MCP server: 66 voices in 9 languages, long-form narration, podcasts.
MCP server exposing the AceDataCloud Fish Audio API (text-to-speech with voice conditioning)
AI voice generation: text-to-speech and voice cloning from any MCP client.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables LLMs to generate spoken audio from text using OpenAI's Text-to-Speech API, supporting various voices, models, and audio formats.11MIT
- AlicenseBqualityDmaintenanceA Node.js server that enables AI assistants to interact with Bouyomi-chan's text-to-speech functionality through Model Context Protocol (MCP), allowing for voice reading of text with adjustable parameters.12MIT
- AlicenseAqualityCmaintenanceA text-to-speech MCP server that enables AI assistants to speak using the VOICEVOX engine with support for multi-character conversations. It features queue management, low-latency streaming via FFplay, and cross-platform playback across Windows, macOS, and Linux.716ISC
- AlicenseAqualityDmaintenanceMCP server that synthesizes Claude Code responses into Japanese speech using VOICEVOX, enabling audible feedback during development.31MIT