MCP VOICEVOX Go

What is MCP VOICEVOX Go?

MCP VOICEVOX Go is a Model Context Protocol server that allows large language models to use VOICEVOX’s Japanese text‑to‑speech engine. It integrates with a locally running VOICEVOX instance and exposes speech synthesis as MCP tools.

How to use MCP VOICEVOX Go?

Ensure Go 1.21+ and a running VOICEVOX instance (default http://localhost:50021). Clone the repository, run go mod tidy, then start the server with go run cmd/server/main.go server or build a binary. Configure port, VOICEVOX URL, temporary directory, and default speaker via command‑line flags or environment variables (e.g. MCP_VOICEVOX_DEFAULT_SPEAKER). For Amazon Q Developer CLI, register the server with q mcp add.

Key features of MCP VOICEVOX Go

• Converts text to synthesized speech via VOICEVOX.
• Lists available speakers and their IDs.
• Customizable server port, VOICEVOX endpoint, temp directory, and default speaker.
• Supports environment variable configuration.
• Designed for use with MCP‑compatible clients (e.g. Amazon Q).

Use cases of MCP VOICEVOX Go

• Adding voice output to LLM‑powered chatbots or assistants.
• Generating audio files from text on demand.
• Enabling accessibility features in LLM applications.
• Integrating Japanese text‑to‑speech into development workflows.

FAQ from MCP VOICEVOX Go

What prerequisites are needed?

Go 1.21 or later and a locally running VOICEVOX instance (default http://localhost:50021).

How do I change the default speaker?

Use the --default-speaker flag or set the MCP_VOICEVOX_DEFAULT_SPEAKER environment variable.

How can I use this server with Amazon Q Developer CLI?

Register it as an MCP server with q mcp add --name voicevox --command "./mcp-voicevox server". Environment variables can be passed with --env.

What tools does the server provide?

Two tools: text_to_speech (requires text, optional speaker_id) and get_speakers (returns a list of available speakers).

Can I use this server with other MCP clients besides Amazon Q?

Yes, it is a standard MCP server; the Amazon Q example is one possible client integration.