# Voicevox Mcp Server

> MCP server from Dosugamea/voicevox-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-dosugamea-voicevox-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Dosugamea](https://agentstack.voostack.com/s/dosugamea)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Dosugamea](https://github.com/Dosugamea)
- **Source:** https://github.com/Dosugamea/voicevox-mcp-server

## Install

```sh
agentstack add mcp-dosugamea-voicevox-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Voicevox MCP Server

VOICEVOX互換の音声合成サーバー(AivisSpeech / VOICEVOX / COEIROINK) を MCP (Model Context Protocol) 経由で利用するためのサーバーです。
Cursor等でのClaude 3.7を使ったエージェントモードでの音声合成に利用できます。

## 必要条件

### Windows環境

- Node.js 18以上
- VOICEVOX ENGINE等 (ローカルでhttp://localhost:50000等で実行)
- VLCメディアプレーヤー（パスが通っていること）

### Docker環境 (WSL2)

- Docker と Docker Compose
- WSL2
- VOICEVOX ENGINE等 (ローカルまたはDockerで実行)
- `sudo apt install libsdl2-dev pulseaudio-utils pulseaudio` されたLinux環境
- `/mnt/wslg` へのアクセス権限

## インストールと設定

1. リポジトリをクローン
```
git clone https://github.com/Dosugamea/voicevox-mcp-server.git
cd voicevox-mcp-server
```

2. 依存関係のインストール
```
npm install
```

3. 環境変数の設定
`.env_example` をコピーして `.env` ファイルを作成し、必要に応じて設定を変更します:
```
VOICEVOX_API_URL=http://localhost:50021
VOICEVOX_SPEAKER_ID=1
```

## 実行方法

### Windows環境での実行
エディタと別途で下記手順でサーバーを立ち上げてください。

```
npm run build
npm start
```

### Docker環境での実行
エディタと別途での操作は不要です。
stdioモードで立ち上がるため直接実行することはできません。

## 設定方法

### Windows環境での実行の場合
mcp.jsonに下記を追記してください。
接続が不安定なため切断されたら再接続してください。

```json
        "voicevox": {
            "url": "http://localhost:10100/sse"
        }
```

### Docker環境での実行の場合
mcp.jsonに下記を追記してください。
(作者環境での動作は確認できていません)

```json
{
    "tools": {
        "voicevox": {
            "command": "cmd",
            "args": [
                "/c",
                "docker",
                "run",
                "-i",
                "--rm",
                "-v",
                "/mnt/wslg:/mnt/wslg",
                "-e",
                "PULSE_SERVER",
                "-e",
                "SDL_AUDIODRIVER",
                "-e",
                "VOICEVOX_API_URL",
                "-e",
                "VOICEVOX_SPEAKER_ID",
                "your-local-docker-image-name"
            ],
            "env": {
                "PULSE_SERVER": "unix:/mnt/wslg/PulseServer",
                "SDL_AUDIODRIVER": "pulseaudio",
                "VOICEVOX_API_URL": "http://host.docker.internal:50031",
                "VOICEVOX_SPEAKER_ID": "919692871"
            }
        }
    }
}
```

## 話者IDについて

話者IDは使用するVOICEVOXのモデルによって異なります。デフォルトでは「1」（四国めたん）を使用しています。
他の話者IDを使用する場合は、環境変数 `VOICEVOX_SPEAKER_ID` を変更してください。

話者IDの一覧は、VOICEVOX ENGINE APIの `/speakers` エンドポイントで確認できます。
例: `curl http://localhost:50021/speakers`

## トラブルシューティング

- **VOICEVOXとの接続エラー**: VOICEVOX ENGINEが起動していること、APIのURLが正しく設定されていることを確認してください。
- **音声が再生されない**: VLCが正しくインストールされていることと、パスが通っていることを確認してください。
- **Docker環境での音声出力問題**: pulseaudioの設定が正しいか確認してください。

## 開発者向け情報

- ソースコードに貢献する場合は、Issueを作成するか、Pull Requestを送信してください。
- バグ報告や機能リクエストは、GitHubのIssue機能をご利用ください。

## ライセンス

MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Dosugamea](https://github.com/Dosugamea)
- **Source:** [Dosugamea/voicevox-mcp-server](https://github.com/Dosugamea/voicevox-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dosugamea-voicevox-mcp-server
- Seller: https://agentstack.voostack.com/s/dosugamea
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.