[![Built by 合同会社みやび](https://img.shields.io/badge/Built%20by-合同会社みやび-blue?style=flat-square&logo=github)](https://miyabi-ai.jp)

# 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:
   ```bash
   cd ~/dev/voicebox-tts
   ./scripts/start.sh
   ```

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

## Installation

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

## Claude Code Configuration

Add to `~/.claude/settings.json`:

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

## Available Speakers

| ID | Name |
|----|------|
| 0 | 四国めたん (あまあま) |
| 1 | 四国めたん (ノーマル) |
| 2 | 四国めたん (セクシー) |
| 3 | ずんだもん (ノーマル) |
| 4 | ずんだもん (あまあま) |
| 5 | ずんだもん (悲嘆) |
| 6 | 春日部つむぎ (ノーマル) |
| 7 | 春日部つむぎ (あまあま) |
| 8 | 春日部つむぎ (ツンデレ) |

## 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

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