Vrchat MCP Osc

🚀 VRChat MCP OSC

VRChat MCP OSC は、Model Context Protocol (MCP) を通じて AI アシスタントと VRChat の間の架け橋を築き、人工知能に基づくバーチャルアバターの制御とインタラクションを実現し、仮想現実環境でのサポートを提供します。

🚀 クイックスタート

VRChat MCP OSC は、Open Sound Control (OSC) を利用して VRChat と通信し、Claude などの AI アシスタントが以下の操作を行えるようにします。

• キャラクターのパラメータと表情を制御する
• メッセージを送信する
• その他のインタラクション操作を実行する

✨ 主な機能

• AI 駆動のバーチャルアバター制御：MCP プロトコルを通じて、AI がバーチャルキャラクターを細かく制御できます。
• 多プラットフォーム互換性：さまざまなデバイスと VR システムをサポートし、幅広い互換性を確保します。
• 効率的な通信メカニズム：OSC を利用して、低遅延で効率的なデータ転送を実現します。

📦 インストール

システム要件

• Node.js 18 以上のバージョン
• OSC をサポートする VRChat
• MCP を実装した Claude Desktop

コマンドライン設定

# プロジェクトディレクトリを作成して移動する
mkdir -p vrchat-mcp-osc
cd vrchat-mcp-osc

# リポジトリをクローンする
git clone https://github.com/Krekun/vrchat-mcp-osc.git .

# 依存関係をインストールする
pnpm install

# プロジェクトをビルドする
pnpm build

# サービスを起動する
npm start

📚 ドキュメント

パラメータ設定

基本パラメータ

--port <number>         # リスニングポート、デフォルト値は 3000
--host <string>         # リスニングアドレス、デフォルトは localhost
--debug                 # デバッグモードを有効にする

高度なオプション

--max_connections <number>  # 最大接続数、デフォルトは 100
--timeout <seconds>        # アイドルタイムアウト時間、単位は秒、デフォルトは 3600

機能モジュール

コアコンポーネント

• MCP サーバー：AI からの命令とデータを処理します。
• WebSocket リレー：WebSocket から OSC へのプロトコル変換を実現します。
• 型定義：統一された TypeScript インターフェース規格を提供します。

ツールセット

• ログ記録と監視：システムの実行状態をリアルタイムで追跡します。
• パフォーマンス最適化ツール：通信効率と安定性を向上させます。

プロジェクトアーキテクチャ

vrchat-mcp-osc/
├── packages/
│   ├── mcp-server/    # MCP プロトコル実装のメインエントリーポイント
│   ├── relay-server/  # WebSocket から OSC へのプロトコル変換器
│   ├── types/         # 共有の TypeScript インターフェース定義
│   └── utils/         # 一般的なユーティリティ関数
└── pnpm-workspace.yaml  # ワークスペース設定ファイル

開発ガイド

ソースコードのビルド

# リポジトリをクローンする
git clone https://github.com/Krekun/vrchat-mcp-osc.git

# 依存関係をインストールする
pnpm install

# すべてのパッケージをビルドする
pnpm -r build

# 開発モードで起動する
pnpm -r dev

📄 ライセンス

VRChat MCP OSC は、二重ライセンスを採用しています。

• 非商用利用：MIT ライセンスに従い、詳細は MIT ライセンスファイルを参照してください。
• 商用利用：別途商用ライセンスを取得する必要があります。

このソフトウェアを非商用目的で MIT ライセンスを使用する場合は、そのライセンス条項に従う必要があります。商用ユーザーは、適切な商用ライセンスを取得する必要があります。

謝辞

以下のチームとプロジェクトの貢献に感謝します。

• VRChat チームが行った OSC 統合の作業
• Model Context Protocol が提供する標準化された AI インターフェース
• Anthropic が行った Claude の MCP 実装