VRChat MCP OSC
VRChat MCP OSC
VRChat MCP OSC は、モデルコンテキストプロトコル (MCP) を使用して AI アシスタントと VRChat 間のブリッジを提供し、仮想現実環境での AI 駆動型アバター制御とインタラクションを可能にします。
概要
VRChat との通信に OSC (Open Sound Control) を活用することで、 VRChat MCP OSC はClaude のような AI アシスタントに次のことを可能にします。
アバターのパラメータと表情を制御する
VRChatでメッセージを送信する
様々なVRイベントに対応
さらに、モデル コンテキスト プロトコルによって提供される高レベル API を通じて、さらに多くのことが可能になります。
Related MCP server: Blender MCP
主な特徴
アバターコントロール:アバターのパラメータと表情を操作する
移動制御:アバターの移動と向きを直接制御
コミュニケーション: VRChatのチャットボックスからメッセージを送信する
メニューアクセス: VRChatのメニューとインターフェース要素を切り替える
アバター情報: アバターのプロパティとパラメータを照会する
シームレスなVRChat統合:アバター構成の自動検出
システム要件
Node.js 18以上
OSC を有効にした VRChat
Claude Desktop(MCP サポート付き)
Claude Desktopでの使用
クローンとnpmリンク
git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc
npm linkClaudeデスクトップの設定
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ポート | 8765 | WebSocket通信の場合 |
| WebSocketホスト | ローカルホスト | WebSocket通信の場合 |
| OSC送信ポート | 9000 | VRChatへの送信ポート |
| OSC送信IP | 127.0.0.1 | VRChatへの送信先アドレス |
| OSC受信ポート | 9001 | VRChatからの受信ポート |
| OSC受信IP | 127.0.0.1 | VRChatからの受信アドレス |
| デバッグログを有効にする | 間違い | 詳細ログを出力する |
| リレーサーバーを無効にする | 間違い | リレーサーバーを使用しない場合 |
利用可能なMCPツール
VRChat MCP OSC は、次の MCP ツールを AI アシスタントに公開します。
ツール名 | 説明 |
| 現在のアバターの名前を取得します |
| 利用可能なアバターパラメータを一覧表示します |
| 特定のアバターパラメータを設定する |
| アバターエモートをトリガーする |
| アバターを特定の方向に移動させます |
| アバターの視線方向を制御します |
| アバターをジャンプさせる |
| VRChatメニューを切り替えます |
| 音声機能を切り替える |
| VRChatチャットボックスにメッセージを送信します |
トラブルシューティング
よくある問題
VRChatがコマンドに応答しない
VRChat設定でOSCが有効になっていることを確認してください
VRChatとMCPの設定間でOSCポートが一致していることを確認します
VRChatとClaude Desktopを再起動します
MCP サーバーが起動しない
Node.js 18以上がインストールされていることを確認する
コマンドライン引数にエラーがないか確認する
より詳細なログを取得するには、
--debugフラグを付けて実行してみてください。直接引数が機能しない場合は、
npx vrchat-mcp-osc -- --debugを使用してください。
NPX実行の問題
引数が認識されない場合は、二重ダッシュ形式を試してください:
npx vrchat-mcp-osc -- --debugWindowsでは、管理者権限でコマンドプロンプトから実行してみてください。
グローバルインストールで問題がある場合は、ローカルnpmリンクアプローチを試してください。
プロジェクト構造
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ライセンスの条件に従って、ソフトウェアを使用、変更、再配布することができます。(詳細については、MITライセンスファイルを参照してください。)
商用利用の場合: このソフトウェアを商用利用するには、別途商用ライセンスが必要です。
このソフトウェアをMITライセンスに基づいて非営利目的で使用する場合、当該ライセンスの条件に同意したことになります。商用目的で使用する場合、上記の商用ライセンスを取得する必要があります。
謝辞
OSC統合のVRChatチーム
標準化された AI インターフェースのためのモデルコンテキストプロトコル
Claude の MCP 実装における Anthropic
Available Tools
12 toolsget_avatar_listB
Get a list of available avatars.
Inputs: no named parameters.
get_avatar_nameB
Get the name of the current avatar.
Inputs: no named parameters.
get_avatar_parametersB
Get a list of parameters available on the current avatar.
Inputs: no named parameters.
jumpB
Make the avatar jump.
Inputs: no named parameters.
look_directionC
Turn to look in a specific direction.
Inputs: direction (required), duration.
move_avatarC
Move the avatar in a specific direction.
Inputs: direction (required), duration.
send_messageB
Send a message to the VRChat chatbox.
Inputs: message (required), send_immediately.
set_avatarC
Change to a specific avatar.
Inputs: avatar_id (required).
set_avatar_parameterC
Set a parameter on the current avatar.
Inputs: parameter_name (required), value (required).
set_emote_parameterC
Set VRCEmote on the current avatar.
Inputs: value (required).
voiceC
Toggle voice
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have distinct purposes, but there is some potential overlap between 'move_avatar' and 'look_direction' for avatar movement/positioning, and 'set_avatar_parameter' and 'set_emote_parameter' both involve parameter setting. The descriptions help clarify differences, but an agent might occasionally confuse these pairs.
The naming follows a consistent verb_noun pattern (e.g., get_avatar_list, set_avatar_parameter) with minor deviations like 'jump' and 'voice' being single words instead of verb_noun pairs. Overall, it's readable and mostly predictable, though not perfectly uniform.
With 12 tools, this is well-scoped for controlling VRChat avatars via OSC. Each tool serves a clear purpose, such as avatar management, movement, communication, and parameter control, without feeling excessive or insufficient for the domain.
The toolset covers key aspects like avatar selection, movement, communication, and parameter control, but there are minor gaps such as missing tools for advanced interactions (e.g., gesture controls or environment manipulation). However, agents can likely work around these with the provided tools.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Connect AI agents to Replynodes over the Model Context Protocol.
Human-input bridge for AI agents with voice-first answer links, MCP tools, and HTTP APIs.
Related MCP Servers
- AlicenseBqualityCmaintenanceA Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.1854 npm71MIT
- AlicenseNot gradedqualityDmaintenanceConnects Blender to AI assistants through the Model Context Protocol, enabling direct AI control of 3D modeling, scene creation, and manipulation via natural language.MIT
- AlicenseAqualityDmaintenanceConnects Blender 3D to AI assistants via the Model Context Protocol, enabling natural language driven 3D scene creation, manipulation, and rendering.15MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to show, animate, and control a VRM character on the desktop, including posing and motion installation via MCP tools.1MIT