MCP TTS VOICEVOX

インストール例：

• Windows（以下のいずれか）

  • Winget：winget install --id=Gyan.FFmpeg -e
  • Chocolatey：choco install ffmpeg
  • Scoop：scoop install ffmpeg
  • 公式ビルド：https://www.gyan.dev/ffmpeg/builds/ または https://github.com/BtbN/FFmpeg-Builds からダウンロードし、bin フォルダーを PATH に追加します

• macOS

  • Homebrew：brew install ffmpeg

• Linux

  • Debian/Ubuntu：sudo apt-get update && sudo apt-get install -y ffmpeg
  • Fedora：sudo dnf install -y ffmpeg
  • Arch：sudo pacman -S ffmpeg

PATH の設定：

• Windows：環境変数に ...\ffmpeg\bin を追加し、PowerShell／ターミナルとエディター（Claude／VS Code など）を再起動します
  • 確認方法：powershell -c "$env:Path" に ffmpeg のパスが含まれている必要があります
• macOS/Linux：通常は自動検出されます。必要に応じて echo $PATH で確認し、シェルを再起動してください。
• MCP クライアント（Claude Desktop/Code）：PATH を再読み込みするため、アプリを再起動してください。

確認：

ffplay -version

バージョン情報が表示されれば、インストールは完了です。CLI／MCP は ffplay を自動検出し、stdin ストリーミング再生を使用します。

ユーザー辞書ツール（グループ dictionary）：

--disable-tools ／ VOICEVOX_DISABLED_TOOLS でツールを個別に無効化するか、--disable-groups ／ VOICEVOX_DISABLED_GROUPS でグループ単位で無効化できます。

VOICEVOX の設定

再生オプション

制限設定

AI が特定のオプションを指定できないように制限します。

ツールの無効化

# Disable individual tools
export VOICEVOX_DISABLED_TOOLS=speak_player,synthesize_file

# Disable a built-in group of tools
export VOICEVOX_DISABLED_GROUPS=player

# Combine groups and individual tools
export VOICEVOX_DISABLED_GROUPS=dictionary
export VOICEVOX_DISABLED_TOOLS=synthesize_file

VOICEVOX_DISABLED_GROUPS / --disable-groups の組み込みグループ：

UI プレーヤーの設定

ファイル出力の設定

サーバー設定

コマンドライン引数は環境変数より優先されます。 最新のオプション一覧は、常に npx @kajidog/mcp-tts-voicevox --help で確認できます。

# Basic settings
npx @kajidog/mcp-tts-voicevox --url http://192.168.1.100:50021 --speaker 3 --speed 1.2

# HTTP mode
npx @kajidog/mcp-tts-voicevox --http --port 8080

# With restrictions
npx @kajidog/mcp-tts-voicevox --restrict-immediate --restrict-wait-for-end

# Disable individual tools
npx @kajidog/mcp-tts-voicevox --disable-tools speak_player,synthesize_file

# Disable a tool group
npx @kajidog/mcp-tts-voicevox --disable-groups player

環境変数や CLI 引数の代わりに（またはそれらと併せて）、JSON 設定ファイルを使用できます。設定項目が多い場合に便利です。

優先順位： CLI 引数 > 環境変数 > 設定ファイル > デフォルト

設定ファイルを生成する

npx @kajidog/mcp-tts-voicevox --init

現在のディレクトリに、すべてのデフォルト設定を含む .voicevoxrc.json が作成されます。必要に応じて編集してください。

カスタム設定ファイルのパスを使用する

npx @kajidog/mcp-tts-voicevox --config ./my-config.json

または、環境変数で指定します：

VOICEVOX_CONFIG=./my-config.json npx @kajidog/mcp-tts-voicevox

.voicevoxrc.json の例

{
  "url": "http://192.168.1.50:50021",
  "speaker": 3,
  "speed": 1.2,
  "http": true,
  "port": 8080,
  "disable-tools": ["synthesize_file"],
  "disable-groups": ["dictionary"]
}

キーは kebab-case（use-streaming）、camelCase（useStreaming）、または内部キー名（defaultSpeaker）で記述できます。現在のディレクトリに .voicevoxrc.json がある場合、自動的に読み込まれます。

リモート接続の場合：

サーバーを起動：

# Linux/macOS
MCP_HTTP_MODE=true MCP_HTTP_PORT=3000 npx @kajidog/mcp-tts-voicevox

# Windows PowerShell
$env:MCP_HTTP_MODE='true'; $env:MCP_HTTP_PORT='3000'; npx @kajidog/mcp-tts-voicevox

Claude Desktop の設定（mcp-remote を使用）：

{
  "mcpServers": {
    "tts-mcp-proxy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

Windows 上で実行されている MCP サーバーに WSL から接続します。

1. WSL から Windows ホストの IP アドレスを取得する

# Method 1: From default gateway
ip route show | grep -oP 'default via \K[\d.]+'
# Usually in the format 172.x.x.1

# Method 2: From /etc/resolv.conf (WSL2)
cat /etc/resolv.conf | grep nameserver | awk '{print $2}'

2. Windows 上でサーバーを起動する

WSL からのアクセスを許可するため、WSL ゲートウェイの IP アドレスを MCP_ALLOWED_HOSTS に追加します。

$env:MCP_HTTP_MODE='true'
$env:MCP_ALLOWED_HOSTS='localhost,127.0.0.1,172.29.176.1'
npx @kajidog/mcp-tts-voicevox

または、CLI 引数を使用します。

npx @kajidog/mcp-tts-voicevox --http --allowed-hosts "localhost,127.0.0.1,172.29.176.1"

3. WSL の設定（.mcp.json）

{
  "mcpServers": {
    "tts": {
      "type": "http",
      "url": "http://172.29.176.1:3000/mcp"
    }
  }
}

⚠️ WSL 内では、localhost は WSL 自体を指します。Windows ホストにアクセスするには、WSL ゲートウェイの IP アドレスを使用してください。

ChatGPT で使用するには、VOICEVOX Engine にアクセスできる状態で、MCP サーバーを HTTP モードでクラウドにデプロイします。

1. クラウドにデプロイする

Docker を使用して Render、Railway などにデプロイします（Dockerfile が含まれています）。

2. VOICEVOX Engine をセットアップする

VOICEVOX Engine をローカルで実行して ngrok 経由で公開するか、MCP サーバーと同じ場所にデプロイします。

3. 環境変数を設定する

4. ChatGPT にコネクターを追加する

ChatGPT の「設定」→「コネクター」→「MCP サーバー URL を追加」に進みます（https://your-app.onrender.com/mcp）。

基本的な手順は ChatGPT と同じですが、VOICEVOX_PLAYER_DOMAIN の値が異なります。

Claude Web では、ui.domain にハッシュベースの専用ドメインが必要です。次のコマンドで算出します。

node -e "console.log(require('crypto').createHash('sha256').update('Your MCP server URL').digest('hex').slice(0,32)+'.claudemcpcontent.com')"

例：MCP サーバーの URL が https://your-app.onrender.com/mcp の場合：

node -e "console.log(require('crypto').createHash('sha256').update('https://your-app.onrender.com/mcp').digest('hex').slice(0,32)+'.claudemcpcontent.com')"
# Example output: 48fb73a6...claudemcpcontent.com

この出力値を VOICEVOX_PLAYER_DOMAIN として設定します。

注：ChatGPT と Claude Web では異なる VOICEVOX_PLAYER_DOMAIN の値が必要なため、1 つのインスタンスで両方のクライアントに同時に対応することはできません。それぞれに別のインスタンスをデプロイするか、対象のクライアントに応じて環境変数を切り替えてください。

1. VOICEVOX Engine が実行中か確認する

curl http://localhost:50021/speakers

2. プラットフォーム固有の再生ツールを確認する

• パッケージのインストールを確認します：npm list -g @kajidog/mcp-tts-voicevox
• 設定ファイル内の JSON 構文を確認します
• クライアントを再起動します

セットアップ

git clone https://github.com/kajidog/mcp-tts-voicevox.git
cd mcp-tts-voicevox
pnpm install

コマンド

パッケージマネージャーにはpnpmを使用します（npm／yarn はサポートされていません）。

開発サーバーはサーバーパッケージ内にあるため、フィルターを指定して実行してください。