resonite-mcp

🎭 Resonite MCP 与仪表盘

与您的虚拟世界对话。

Resonite MCP 是一座集成桥梁，也是一个先进的 Web 仪表盘，可将 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 导出器、模组工具、模型库、社区链接，以及导入 Resonite 的途径。
• 🛰️ Fleet 应用中心：实时列出所有已安装的 Fleet Web 应用，并显示运行状态指示点，支持点击打开。
• 🎨 可视化仪表盘与图库：监控连接状态、查看世界的节点树，并浏览屏幕截图和热门世界的可视化图库。

---

🌐 构建与入驻 Fleet 生态系统

此代码库不仅是一个独立连接器，也是更广泛的 多 Agent Fleet 生态系统中的重要节点：

• 多节点联邦：支持在标准目录 ~/.avatarmcp/ 下缓存联邦资源，并使用 MCP_BRIDGE_URLS 在开发者节点之间跨网络同步状态。
• 构建与入驻流水线：将外部设计环境（如 Blender、GIMP 和 Inkscape）直接集成到 VR 平台（如 Resonite、VRChat 和 Vircadia）。资源会自动编译、暂存，通过 WebSocket 在世界内生成，并由 Agent 通过实时 OSC 遥测数据入驻。
• 如需了解架构、设置阶段和平台行为的完整详情，请阅读 构建与入驻流水线指南 和 VR 世界比较指南。

---

⛩️ 巫女的数字神社

秉承神与巫女的精神——这个 MCP 服务充当人类创作者与虚拟世界数字精灵之间的桥梁。可爱机敏的巫女守护着代码神社，确保创造之神能够自由流经我们的数字空间。

---

🚀 快速开始（3 步即可运行）

步骤 1：启动 Resonite

确保 Resonite 游戏客户端正在 Steam 上运行。在会话设置中启用 ResoniteLink 连接（Dashboard ➔ Session ➔ Settings ➔ Enable ResoniteLink）。

步骤 2：启动 Dashboard

克隆代码库并启动前端 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"]
  }
}

---

Fleet 互联（配套服务）

resonite-mcp 完全可以独立运行。你也可以选择将它与 sandraschi fleet 中的配套服务连接，以解锁扩展功能：

配套服务	解锁的功能	状态	设置
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	可选	安装指南

独立运行的配套服务：Fleet 配套服务可独立运行。安装配套服务不会触发传递依赖链。

---

📚 文档索引

如需深入了解架构细节、设置建议和 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 模组制作、视频教程、subreddit 和 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 社区打造。