vrchat-mcp-osc

VRChat MCP OSC

VRChat MCP OSC は、Model Context Protocol（MCP）を使用して AI アシスタントと VRChat をつなぐブリッジを提供し、バーチャルリアリティ環境における AI によるアバター制御やインタラクションを可能にします。

概要

OSC（Open Sound Control）を活用して VRChat と通信することで、VRChat MCP OSC は Claude などの AI アシスタントに次の機能を提供します。

• アバターのパラメーターや表情を制御する
• VRChat でメッセージを送信する
• さまざまな VR イベントに応答する
  さらに、Model Context Protocol が提供する高水準 API を通じて、さまざまな操作が可能です。

主な機能

• アバター制御：アバターのパラメーターや表情を操作します
• 移動制御：アバターの移動や向きを指定します
• コミュニケーション：VRChat のチャットボックスからメッセージを送信します
• メニューへのアクセス：VRChat のメニューやインターフェース要素を切り替えます
• アバター情報：アバターのプロパティやパラメーターを取得します
• シームレスな VRChat 連携：アバター設定を自動的に検出します

システム要件

• Node.js 18 以降
• OSC が有効になっている VRChat
• Claude Desktop（MCP 対応）

Claude Desktop での使用

クローンして npm link を実行

git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc
npm link

Claude Desktop の設定

claude_desktop_config.json ファイルを編集して、Claude Desktop を設定します。

{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc"
      ]
    }
  }
}

コマンドラインオプション

サーバーは、カスタマイズ用のさまざまなコマンドライン引数に対応しています。

# Claude Desktop configuration
{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc",
        "--websocket-port", "8765",
        "--websocket-host", "localhost",
        "--osc-send-port", "9000",
        "--osc-send-ip", "127.0.0.1",
        "--osc-receive-port", "9001",
        "--osc-receive-ip", "127.0.0.1",
        "--debug"             
      ]
    }
  }
}

使用可能なオプション

オプション	説明	デフォルト	備考
--websocket-port <port>	WebSocket ポート	8765	WebSocket 通信に使用
--websocket-host <host>	WebSocket ホスト	localhost	WebSocket 通信に使用
--osc-send-port <port>	OSC 送信ポート	9000	VRChat への送信に使用するポート
--osc-send-ip <ip>	OSC 送信 IP	127.0.0.1	VRChat への送信に使用するアドレス
--osc-receive-port <port>	OSC 受信ポート	9001	VRChat からの受信に使用するポート
--osc-receive-ip <ip>	OSC 受信 IP	127.0.0.1	VRChat からの受信に使用するアドレス
--debug	デバッグログを有効にする	false	詳細なログを出力
--no-relay	リレーサーバーを無効にする	false	リレーサーバーを使用しない場合

使用可能な MCP ツール

VRChat MCP OSC は、以下の MCP ツールを AI アシスタントに公開します。

ツール名	説明
get_avatar_name	現在のアバター名を取得します
get_avatar_parameters	使用可能なアバターパラメーターを一覧表示します
set_avatar_parameter	指定したアバターパラメーターを設定します
set_emote_parameter	アバターのエモートを起動します
move_avatar	アバターを指定した方向に移動します
look_direction	アバターの視線方向を制御します
jump	アバターをジャンプさせます
menu	VRChat のメニューを切り替えます
voice	音声機能を切り替えます
send_message	VRChat のチャットボックスにメッセージを送信します

トラブルシューティング

よくある問題

1. VRChat がコマンドに応答しない

   • VRChat の設定で OSC が有効になっていることを確認します
   • VRChat と MCP の設定で OSC ポートが一致していることを確認します
   • VRChat と Claude Desktop を再起動します

2. MCP サーバーが起動しない

   • Node.js 18 以降がインストールされていることを確認します
   • コマンドライン引数にエラーがないか確認します
   • より詳細なログを確認するには、--debug フラグを付けて実行します
   • 直接引数を指定しても機能しない場合は、npx vrchat-mcp-osc -- --debug を使用します

3. NPX の実行に関する問題

   • 引数が認識されない場合は、二重ダッシュ形式を使用してみてください：npx vrchat-mcp-osc -- --debug
   • Windows では、管理者権限でコマンドプロンプトから実行してみてください
   • グローバルインストールで問題が発生する場合は、ローカルの npm link を試してください

プロジェクト構成

vrchat-mcp-osc/
├── packages/
│   ├── mcp-server/    # MCP server implementation (main entry point)
│   ├── relay-server/  # WebSocket to OSC relay
│   ├── types/         # Shared TypeScript interfaces
│   └── utils/         # Common utilities
└── pnpm-workspace.yaml  # Workspace configuration

開発

ソースからビルド

# Clone the repository
git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc

# Install dependencies
pnpm install

# Build all packages
pnpm -r build

# Development mode
pnpm -r dev

ライセンス

VRChat MCP OSC は、以下のデュアルライセンスです。

非営利目的での利用： MIT License の条件に従って、ソフトウェアを使用、変更、再配布できます。 （詳細については、MIT License ファイルをご覧ください。）

営利目的での利用： このソフトウェアを営利目的で利用するには、別途商用ライセンスが必要です。

非営利目的で MIT License に基づいてこのソフトウェアを使用することで、そのライセンスの条件に同意したものとみなされます。営利目的で利用する場合は、上記のとおり商用ライセンスを取得する必要があります。

謝辞

• OSC 統合を提供してくれた VRChat チーム
• 標準化された AI インターフェースを提供する Model Context Protocol
• Claude の MCP 実装を提供してくれた Anthropic