VoiceBox MCP Server

Model Context Protocol (MCP) server for VOICEVOX text-to-speech integration.

Features

• voicebox_speak - Convert text to speech

• voicebox_status - Check task status

• voicebox_speakers - List available speakers

• voicebox_health - Check system health

• voicebox_metrics - Get system metrics

Prerequisites

1. VoiceBox TTS API must be running:

   cd ~/dev/voicebox-tts
   ./scripts/start.sh

2. VOICEVOX must be running with API server enabled (port 50021)

Installation

cd ~/dev/voicebox-mcp
npm install
npm run build

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "voicebox": {
      "command": "node",
      "args": ["/Users/shunsukehayashi/dev/voicebox-mcp/dist/index.js"],
      "env": {
        "VOICEBOX_API_URL": "http://localhost:5001"
      }
    }
  }
}

Available Speakers

Usage in Claude Code

Please use voicebox_speak to say "Hello, world!" with speaker 3 (Zundamon).

Check the voicebox system health.

List all available VOICEVOX speakers.

Development

npm run dev    # Watch mode
npm run build  # Build
npm start      # Run server