Voicevox MCP Server logo

Voicevox MCP Server

by Dosugamea

This server allows you to use VOICEVOX-compatible speech synthesis engines (AivisSpeech / VOICEVOX / COEIROINK) via the Model Context Protocol (MCP). It can be used for voice synthesis in agent mode with Claude 3.7 in Cursor, etc.

View on GitHub

Last updated: N/A

What is Voicevox MCP Server?

A server to utilize VOICEVOX-compatible speech synthesis engines (AivisSpeech / VOICEVOX / COEIROINK) through the Model Context Protocol (MCP).

How to use Voicevox MCP Server?

  1. Clone the repository. 2. Install dependencies with npm install. 3. Configure environment variables in .env. 4. Run the server with npm run build and npm start (Windows) or using Docker Compose. 5. Configure mcp.json with the appropriate URL or Docker command.

Key features of Voicevox MCP Server

  • VOICEVOX Compatibility

  • MCP Integration

  • Windows Support

  • Docker Support

  • Configurable Speaker ID

Use cases of Voicevox MCP Server

  • Agent-based voice synthesis

  • Automated voice generation

  • Text-to-speech applications

  • Integration with Cursor and Claude 3.7

FAQ from Voicevox MCP Server

How do I resolve VOICEVOX connection errors?

Ensure that the VOICEVOX ENGINE is running and the API URL is configured correctly.

Why is there no audio playback?

Verify that VLC is installed correctly and the path is set.

What should I do about audio output issues in Docker?

Check the pulseaudio configuration.

How do I find the speaker ID?

You can find the speaker ID by querying the /speakers endpoint of the VOICEVOX ENGINE API (e.g., curl http://localhost:50021/speakers).

What is the default speaker ID?

The default speaker ID is 1 (Shikoku Metan).