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
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 install
Configuration
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-10000
Usage
Running the MCP Server
# Run directly with tsx (no build required)
npm start
# Or for development with auto-reload
npm run dev
Configuring 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 required
convert_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.SoundPlayer - Linux: 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 dev
License
MIT