resonite-mcp

🎭 Resonite MCP とダッシュボード

仮想世界に話しかけましょう。

Resonite MCP は、AI アシスタントをResoniteソーシャル VR プラットフォームに接続する統合ブリッジ兼最先端のウェブダッシュボードです。自然言語を使って、チャットから直接、世界に指示を出したり、アバターをカスタマイズしたり、セッションを調べたり、テレメトリを制御したりできます。

Claude Desktop（ワンクリック）： irm https://github.com/sandraschi/resonite-mcp/releases/latest/download/install.ps1 | iex その他のクライアント（stdio）：PYTHONPATH=src を設定して python -m resonite_mcp --stdio を実行します。

---

✨ 主な機能

• 🤖 AI アシスタント統合（MCP）：AI チャットクライアントで自然言語を使い、オブジェクトの生成、移動機能の切り替え、アクティブなスロットの変更、ワールドの読み込みを行えます。
• 🧬 アバターと生体情報の調整：トラッキングのスムージングを調整し、アイトラッキングを切り替え、リップシンクのパラメーターをリアルタイムで監視できます。
• 👥 ソーシャルと連絡先：オンラインのユーザーを確認し、チャットログを読み、ワンクリックで友人のセッションに参加できます。
• 📦 ワールド内でのスポーン：インベントリデータベースからアセットを検索、整理し、直接スポーンできます。
• 🏠 ワールドビルダー：フォームから、ライブセッション内に家具付きの部屋を組み立てます。5 種類のスタイル、3 種類のサイズ、4 種類の家具セットに対応し、ResoniteLink 経由でパーツごとにスポーンし、完全なビルドレポートを生成します。
• 📥 アセットのダウンロード：公式マーケットプレイスがないため、このページでは実際のソースをまとめています。Unity エクスポーター、Mod ツール、モデルライブラリ、コミュニティリンクに加え、Resonite へのインポート手順も紹介します。
• 🛰️ Fleet アプリハブ：インストール済みのすべての Fleet ウェブアプリを、稼働状況を示すインジケーター付きのライブレジストリで確認でき、クリックして開けます。
• 🎨 ビジュアルダッシュボードとギャラリー：接続状態を監視し、ワールドのノードツリーを調べ、スクリーンショットや人気のワールドをビジュアルギャラリーで閲覧できます。

---

🌐 Build-and-Inhabit Fleet エコシステム

このリポジトリは単独のコネクターではなく、より大きなマルチエージェント Fleet エコシステムの重要なノードです。

• マルチノード連携：標準ディレクトリ ~/.avatarmcp/ を使用した連携アセットキャッシュに対応し、MCP_BRIDGE_URLS を使って開発ノード間でネットワークをまたいだ状態同期を行います。
• Build-and-Inhabit パイプライン：外部のデザイン環境（Blender、GIMP、Inkscape など）を VR プラットフォーム（Resonite、VRChat、Vircadia など）に直接統合します。アセットは自動的にコンパイル、ステージングされ、WebSockets 経由でワールド内にスポーンされ、エージェントがリアルタイムの OSC テレメトリを通じてその世界を体験します。
• アーキテクチャ、セットアップの段階、プラットフォームの動作に関する詳細は、Build-and-Inhabit パイプラインガイド と VR ワールド比較ガイド をご覧ください。

---

⛩️ ミコのデジタル神社

神と巫女の精神にのっとり、この MCP サーバーは人間のクリエイターと仮想世界のデジタルな精霊をつなぐ架け橋となります。かわいらしく賢い巫女がコードの神社を守り、創造の神々がデジタル空間を自由に巡るよう見守ります。

---

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

ステップ 1：Resonite を起動する

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

ステップ 2：ダッシュボードを起動する

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

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

ウェブダッシュボードは 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"]
  }
}

---

Fleet のクロス接続（コンパニオン）

resonite-mcp は単独で完全に動作します。必要に応じて、sandraschi フリートのコンパニオンサーバーに接続すると、拡張機能を利用できます：

コンパニオンサーバー	利用可能になる機能	ステータス	セットアップ
blender-mcp	asset-decimation, gltf-vrm-pipeline	任意	インストールガイド
yahboom-mcp	digital-twin-visualization, vbot-teleoperation	任意	インストールガイド
teleoperator-mcp	osc-robot-teleop, vr-controller-stream	任意	インストールガイド
mixx-dj-mcp	live-dj-audio-stream, bpm-reactive-dance-rig	任意	インストールガイド

独立して動作するコンパニオン：フリートのコンパニオンはそれぞれ独立して動作します。コンパニオンをインストールしても、依存関係が連鎖的に追加されることはありません。

---

📚 ドキュメント一覧

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

ガイド	説明
ARCHITECTURE.md	システムアーキテクチャの概要、プロトコル、ポートの対応関係
INSTALL.md	インストール手順と環境設定の全容
docs/TOOLS.md	86 個の Python ツールと HTTP API エンドポイントの一覧
docs/RESONITELINK_GUIDE.md	ResoniteLink WebSocket プロトコルの詳細
VR_WORLDS_COMPARISON.md	Resonite、VRChat、Vircadia の詳細な比較
BUILD_AND_INHABIT_PIPELINE.md	Blender/GIMP からライブ VR へのインジェクションまでの自動化ステージ
COMMUNITY_RESOURCES.md	RML のモッディング、動画チュートリアル、サブレディット、Discord へのリンク
BEGINNERS_GUIDE.md	新規ユーザー向けの基本事項と操作方法
docs/ONBOARDING.md	10 分でできるセットアップ：前提条件、環境変数、動作確認、注意点

---

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

• 現在のバージョン：v1.1.0（ResoniteLink Protocol 0.13.1）。
• 準拠状況：Agent Lab のフェーズ 1～6 が完了しています。リアルタイムのスロット CRUD、OSC 同期、キャッシュされたアセットの同期は、すべて実環境での動作確認が完了しています。
• TODO -- 近くのオブジェクトの検索：overte-mcp には、Overte の Entities.findEntities を基盤とする空間クエリ find_nearby があります。ResoniteLink には同等の機能がないため、これは移植されていません。実装するには、単一のサーバー側空間クエリではなく、シーングラフをたどって（ルートから再帰的に get_children/get_slot を呼び出し、クライアント側で距離によるフィルタリングを行う）必要があります。これは単純な移植ではなく、異なる低速な設計になります。overte-mcp から問題なく移植できたその他の機能（animate、fixture spawner、model/texture depot + backup）については、CHANGELOG.md の 2026-09-02 の項目を参照してください。
• ライセンス：MIT ライセンス。Resonite コミュニティへの思いを込めて作られています。