io.github.sandraschi/resonite-mcp

🎭 Resonite MCP & Dashboard

Talk to your virtual world.

Resonite MCP is an integration bridge and state-of-the-art web dashboard that connects AI assistants to the Resonite social VR platform. Using natural language, you can command your world, customize your avatar, inspect your sessions, and control your telemetry directly through chat.

Claude Desktop (1-click): irm https://github.com/sandraschi/resonite-mcp/releases/latest/download/install.ps1 | iex Other clients (stdio): python -m resonite_mcp --stdio with PYTHONPATH=src.

✨ Key Features

• 🤖 AI Assistant Integration (MCP): Use natural language with your AI chat client to spawn objects, toggle locomotion, change active slots, or load worlds.
• 🧬 Avatar & Biometric Tuning: Adjust tracking smoothing, toggle eye tracking, and monitor lipsync parameters in real-time.
• 👥 Socials & Contacts: Check who is online, read chat logs, and join your friends' sessions with one click.
• 📦 In-World Spawning: Search, organize, and spawn assets directly from your inventory database.
• 🏠 World Builder: Assemble a furnished room in your live session from a form — 5 styles, 3 sizes, 4 furniture sets, spawned piece-by-piece over ResoniteLink with a full build report.
• 📥 Asset Downloads: No official marketplace exists, so the page collects the real sources instead — Unity exporter, mod tools, model libraries, community links — plus the import path into Resonite.
• 🛰️ Fleet Apps Hub: Live registry of every installed fleet webapp with health dots and click-to-open.
• 🎨 Visual Dashboard & Gallery: Monitor connection health, inspect the world's node tree, and browse a visual gallery of screenshots and popular worlds.

🌐 The Build-and-Inhabit Fleet Ecosystem

This repository is not just a standalone connector, but a vital node in a wider Multi-Agent Fleet Ecosystem:

• Multi-Node Federation: Supports federated asset caching under the standard directory ~/.avatarmcp/ and uses MCP_BRIDGE_URLS for cross-network state synchronization between developer nodes.
• Build-and-Inhabit Pipeline: Integrates external design environments (such as Blender, GIMP, and Inkscape) directly into VR platforms (such as Resonite, VRChat, and Vircadia). Assets are automatically compiled, staged, spawned in-world over WebSockets, and inhabited by the agent via real-time OSC telemetry.
• For complete details on the architecture, setup stages, and platform behaviors, read the Build-and-Inhabit Pipeline Guide and VR Worlds Comparison Guide.

⛩️ The Miko's Digital Shrine

In the spirit of kami and miko -- this MCP server serves as a bridge between human creators and the digital spirits of virtual worlds. The kawaii and clever miko tends the shrines of code, ensuring the kami of creation flow freely through our digital spaces.

🚀 Quick Start (Get Running in 3 Steps)

Step 1: Launch Resonite

Make sure the Resonite game client is running on Steam. Enable the ResoniteLink connection inside the session settings (Dashboard ➔ Session ➔ Settings ➔ Enable ResoniteLink).

Step 2: Start the Dashboard

Clone the repository and spin up the frontend webapp and Python server:

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

The web dashboard is now active at http://localhost:10978.

Step 3: Connect your AI Assistant

Add the server configuration to your Claude Desktop config file (claude_desktop_config.json):

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

Fleet Crossconnects (Companions)

resonite-mcp works completely standalone. You can optionally connect it with companion servers in the sandraschi fleet to unlock extended features:

Self-Contained Companions: Fleet companions operate independently. Installing companions does not trigger transitive dependency chains.

📚 Documentation Index

For deep architectural details, setup advice, and API references, check out our dedicated guides:

📈 Status & Roadmap

• Current Version: v1.1.0 (ResoniteLink Protocol 0.13.1).
• Compliance: Agent Lab Phases 1–6 complete. Real-time slot CRUD, OSC synchronization, and cached asset syncing are fully live-verified.
• TODO -- nearby-object search: overte-mcp has a spatial find_nearby query built on Overte's Entities.findEntities; ResoniteLink has no equivalent primitive, so this hasn't been ported. Building it would mean walking the scene graph (recursive get_children/get_slot from a root, filtering by distance client-side) instead of a single server-side spatial query -- a different, slower design, not a straight port. See CHANGELOG.md (2026-09-02 entries) for the rest of what did port cleanly from overte-mcp (animate, fixture spawner, model/texture depot + backup).
• License: MIT Licensed. Made with care for the Resonite community.