🎭 Resonite MCP & Dashboard

与你的虚拟世界对话。

Resonite MCP 是一座集成桥梁，也是一个最先进的 Web 仪表盘，它将 AI 助手连接到 Resonite 社交 VR 平台。借助自然语言，你可以直接通过聊天指挥你的世界、自定义你的虚拟形象、查看你的会话，并控制你的遥测数据。

✨ 主要特性

• 🤖 AI 助手集成（MCP）：使用自然语言与你的 AI 聊天客户端交互，生成对象、切换移动模式、更改活动槽位或加载世界。

• 🧬 虚拟形象与生物特征调校：调整追踪平滑度、切换眼部追踪，并实时监控口型同步参数。

• 👥 社交与联系人：查看谁在线、阅读聊天记录，并一键加入朋友的会话。

• 📦 世界内生成：直接从你的库存数据库中搜索、整理和生成资产。

• 🎨 可视化仪表盘与图库：监控连接健康状态、查看世界的节点树，并浏览截图和热门世界的可视化图库。

Related MCP server: ResoniteLink MCP

🌐 Build-and-Inhabit 舰队生态系统

这个仓库不仅仅是一个独立的连接器，更是更广泛的 Multi-Agent Fleet Ecosystem 中的一个关键节点：

• 多节点联邦：支持在标准目录 ~/.avatarmcp/ 下进行联邦资产缓存，并使用 MCP_BRIDGE_URLS 在开发者节点之间进行跨网络状态同步。

• Build-and-Inhabit Pipeline：将外部设计环境（如 Blender、GIMP 和 Inkscape）直接集成到 VR 平台（如 Resonite、VRChat 和 Vircadia）。资产会被自动编译、暂存、通过 WebSockets 生成到世界中，并由智能体通过实时 OSC 遥测进行栖居。

• *要了解架构、设置阶段和平台行为的完整细节，请阅读 Build-and-Inhabit Pipeline Guide 与 VR Worlds Comparison Guide。*

⛩️ 巫女的数字神社

怀着神与巫女的精神——这个 MCP 服务器在人类创作者与虚拟世界的数字精灵之间架起桥梁。这位可爱又聪慧的巫女守护着代码的神社，确保创造之神的灵力在我们的数字空间中自由流动。

🚀 快速开始（3 步上手）

第 1 步：启动 Resonite

确保 Resonite 游戏客户端已在 Steam 上运行。在会话设置中启用 ResoniteLink 连接（仪表盘 ➔ 会话 ➔ 设置 ➔ 启用 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 协议 0.13.1）。

• 合规性：Agent Lab 阶段 1–6 已完成。实时槽位 CRUD、OSC 同步以及缓存资产同步均已通过线上验证。

• 许可证：MIT 许可证。为 Resonite 社区用心制作。