🎭 Resonite MCP & Dashboard

あなたの仮想世界に話しかけよう。

Resonite MCP は、AI アシスタントを Resonite ソーシャル VR プラットフォームに接続する統合ブリッジであり、最先端の Web ダッシュボードです。自然言語を使えば、チャットから直接、ワールドの操作、アバターのカスタマイズ、セッションの確認、テレメトリの制御ができます。

✨ 主な機能

• 🤖 AI アシスタント連携（MCP）: AI チャットクライアントで自然言語を使用して、オブジェクトのスポーン、ロコモーションの切り替え、アクティブスロットの変更、ワールドの読み込みができます。

• 🧬 アバターとバイオメトリクスのチューニング: トラッキングのスムージング調整、アイトラッキングの切り替え、リップシンクパラメータのリアルタイム監視ができます。

• 👥 ソーシャルと連絡先: オンラインの確認、チャットログの閲覧、フレンドのセッションへのワンクリック参加ができます。

• 📦 ワールド内スポーン: インベントリデータベースからアセットを直接検索、整理、スポーンできます。

• 🎨 ビジュアルダッシュボードとギャラリー: 接続状態の監視、ワールドのノードツリーの検査、スクリーンショットと人気ワールドのビジュアルギャラリーの閲覧ができます。

Related MCP server: ResoniteLink MCP

🌐 Build-and-Inhabit フリートエコシステム

このリポジトリは単なるスタンドアロンコネクタではなく、より広範なマルチエージェント・フリート・エコシステムにおける重要なノードです。

• マルチノード・フェデレーション: 標準ディレクトリ ~/.avatarmcp/ 配下でのフェデレーション型アセットキャッシュをサポートし、MCP_BRIDGE_URLS を使用して開発者ノード間のクロスネットワーク状態同期を実現します。

• Build-and-Inhabit パイプライン: 外部デザイン環境（Blender、GIMP、Inkscape など）を VR プラットフォーム（Resonite、VRChat、Vircadia など）に直接統合します。アセットは自動的にコンパイル・ステージングされ、WebSocket 経由でワールド内にスポーンされ、エージェントがリアルタイムの OSC テレメトリを通じてその中に宿ります。

• アーキテクチャ、セットアップ手順、プラットフォームの動作の詳細については、**Build-and-Inhabit Pipeline Guide* と VR Worlds Comparison Guide をお読みください。*

⛩️ 巫女のデジタル神社

神と巫女の精神にのっとり、この MCP サーバーは人間のクリエイターと仮想世界のデジタルな精霊をつなぐ橋渡し役を担います。かわいくて賢い巫女がコードの神社を手入れし、創造の神々が私たちのデジタル空間を自由に流れ続けるようにしています。

🚀 クイックスタート（3 ステップで起動）

ステップ 1: Resonite を起動

Resonite ゲームクライアントが Steam 上で実行されていることを確認してください。セッション設定内で ResoniteLink 接続を有効にします（Dashboard ➔ Session ➔ Settings ➔ Enable ResoniteLink）。

ステップ 2: ダッシュボードを起動

リポジトリをクローンし、フロントエンドの Web アプリと Python サーバーを起動します：

git clone https://github.com/sandraschi/resonite-mcp
cd resonite-mcp
just bootstrap
just serve

Web ダッシュボードは http://localhost:10978 で稼働しています。

ステップ 3: AI アシスタントを接続

サーバー設定を Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します：

"mcpServers": {
  "resonite-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/resonite-mcp", "run", "resonite-mcp"]
  }
}

📚 ドキュメント一覧

詳細なアーキテクチャ、セットアップ方法、API リファレンスについては、専用ガイドをご覧ください：

📈 ステータスとロードマップ

• 現在のバージョン: v1.1.0（ResoniteLink Protocol 0.13.1）。

• 対応状況: Agent Lab フェーズ 1〜6 完了。リアルタイムのスロット CRUD、OSC 同期、キャッシュ済みアセットの同期はすべてライブ検証済みです。

• ライセンス: MIT ライセンス。Resonite コミュニティへの想いを込めて作られています。