Simple VoicevoxSAFE

MCP (Model Context Protocol) を通じて VOICEVOX のテキスト読み上げ機能を提供するシンプルなサーバーです。

概要

このプロジェクトは、VOICEVOX の音声合成エンジンを MCP ツールとして利用できるようにするサーバー実装です。Claude Code 等の MCP クライアントから、テキストの読み上げ機能を簡単に利用できます。

前提条件

• Node.js 18.0.0 以上
• VOICEVOX エンジンが起動している必要があります
• VOICEVOX 公式サイトから VOICEVOX をダウンロード・インストール
• VOICEVOX を起動し、エンジンが http://localhost:50021 で稼働していることを確認

使用方法

MCP クライアント(Claude Code、Claude Desktop 等)の設定ファイルに以下を追加してください。

macOS / Linux / WSL

claude mcp add voicevox -- npx @t09tanaka/mcp-simple-voicevox

{
"mcpServers": {
"voicevox": {
"command": "npx",
"args": ["@t09tanaka/mcp-simple-voicevox"]
}
}
}

Windows(ネイティブ)

claude mcp add voicevox -- cmd /c npx @t09tanaka/mcp-simple-voicevox

{
"mcpServers": {
"voicevox": {
"command": "cmd",
"args": ["/c", "npx", "@t09tanaka/mcp-simple-voicevox"]
}
}
}

その他の設定方法は docs/usage.md を参照してください。

speak ツール

テキストを音声で読み上げます。

パラメータ:

• text (string, 必須): 読み上げるテキスト
• speaker (number, 必須): 話者 ID
• speedScale (number, オプション): 読み上げ速度のスケール(0.5〜2.0、デフォルト: 1.0)
• volumeScale (number, オプション): 音量のスケール(0.0〜2.0、デフォルト: 1.0)
• async (boolean, オプション): 非同期再生モード(falseの場合、音声再生の完了を待ちます。デフォルト: true)

使用例:

{
\"text\": \"こんにちは、これはテスト音声です。\",
\"speaker\": 1,
\"speedScale\": 1.3,
\"volumeScale\": 1.5,
\"async\": true
}

話者 ID について

VOICEVOX で利用可能な話者 ID は、VOICEVOX エンジンの /speakers エンドポイントから取得できます:

curl http://localhost:50021/speakers

一般的な話者 ID(参考):

• 1: 四国めたん(ノーマル)
• 2: 四国めたん(あまあま)
• 3: 四国めたん(ツンツン)
• 8: 春日部つむぎ(ノーマル)
• 10: 雨晴はう(ノーマル)

対応プラットフォーム

音声再生は以下のプラットフォームに対応しています:

• macOS: afplay コマンドを使用
• Linux: aplay コマンドを使用
• Windows: PowerShell の Media.SoundPlayer を使用

トラブルシューティング

VOICEVOX エンジンに接続できない

• VOICEVOX アプリケーションが起動しているか確認
• http://localhost:50021 で VOICEV