io.github.sandraschi/resonite-mcp — Model Context Protocol (MCP) Server

The io.github.sandraschi/resonite-mcp server is an MCP server for the Resonite social VR platform. It enables natural-language control of avatars, worlds, and Proto... based on its provided description. The server is associated with technologies and communities reflected in its topics, including Python and Windows app development.

🛠️ Key Features

Natural-language control for avatars
Natural-language control for worlds
Natural-language control for Proto... (truncated in source data)

🚀 Use Cases

Controlling avatar behavior in Resonite social VR
Navigating or modifying worlds in Resonite
Interacting with Proto... components via language queries

⚡ Developer Benefits

MCP integration for a social VR platform context
Python-oriented implementation (from topics)
Cross-platform application tooling indicated by topics (e.g., Windows apps, webapp)

⚠️ Limitations

The provided description truncates “Proto...,” so the exact Proto scope is not specified
No tool count, readme excerpt, or full feature list is included in the source data

🎭 Resonite MCP & Dashboard

ResoniteLink live-verified

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.

✨ 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.
🎨 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:

powershell

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):

json

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

📚 Documentation Index

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

Guide	Description
ARCHITECTURE.md	High-level system architecture, protocols, and port mappings
INSTALL.md	Full installation paths and environment configurations
docs/TOOLS.md	List of the 65+ Python tools and HTTP API endpoints
docs/RESONITELINK_GUIDE.md	Deep-dive into the ResoniteLink WebSocket protocol
VR_WORLDS_COMPARISON.md	Detailed comparison between Resonite, VRChat, and Vircadia
BUILD_AND_INHABIT_PIPELINE.md	Automation stages from Blender/GIMP to live VR injection
COMMUNITY_RESOURCES.md	Links to RML modding, video tutorials, subreddits, and Discords
BEGINNERS_GUIDE.md	Onboarding basics and control references for new users

📈 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.

io.github.sandraschi/resonite-mcp