🎭 Resonite MCP & Dashboard

가상 세계에 말을 걸어보세요.

Resonite MCP는 AI 비서를 Resonite 소셜 VR 플랫폼에 연결하는 통합 브리지이자 최첨단 웹 대시보드입니다. 자연어를 사용해 채팅으로 직접 월드를 제어하고, 아바타를 커스터마이즈하고, 세션을 확인하고, 텔레메트리를 제어할 수 있습니다.

✨ 주요 기능

• 🤖 AI 비서 통합 (MCP): AI 채팅 클라이언트에서 자연어로 객체를 스폰하고, 이동 방식을 전환하고, 활성 슬롯을 변경하거나 월드를 불러올 수 있습니다.

• 🧬 아바타 및 바이오메트릭 튜닝: 트래킹 스무딩을 조정하고, 아이트래킹을 전환하며, 립싱크 파라미터를 실시간으로 모니터링할 수 있습니다.

• 👥 소셜 및 연락처: 누가 온라인인지 확인하고, 채팅 로그를 읽고, 친구의 세션에 원클릭으로 참여할 수 있습니다.

• 📦 월드 내 스폰: 인벤토리 데이터베이스에서 에셋을 직접 검색, 정리, 스폰할 수 있습니다.

• 🎨 비주얼 대시보드 및 갤러리: 연결 상태를 모니터링하고, 월드의 노드 트리를 확인하며, 스크린샷과 인기 월드의 비주얼 갤러리를 탐색할 수 있습니다.

Related MCP server: ResoniteLink MCP

🌐 Build-and-Inhabit 플릿 생태계

이 저장소는 단순한 독립형 커넥터가 아니라 더 넓은 멀티 에이전트 플릿 생태계의 핵심 노드입니다:

• 멀티 노드 연합: 표준 디렉터리 ~/.avatarmcp/ 아래에서 연합 에셋 캐싱을 지원하고, 개발자 노드 간 네트워크 상태 동기화를 위해 MCP_BRIDGE_URLS를 사용합니다.

• Build-and-Inhabit 파이프라인: 외부 디자인 환경(예: 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 연결을 활성화하세요 (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"]
  }
}

📚 문서 색인

심층 아키텍처 세부 사항, 설정 조언, API 참조를 원한다면 전용 가이드를 확인하세요:

📈 상태 및 로드맵

• 현재 버전: v1.1.0 (ResoniteLink Protocol 0.13.1).

• 준수 사항: Agent Lab 페이즈 1–6 완료. 실시간 슬롯 CRUD, OSC 동기화, 캐시된 에셋 동기화가 완전히 라이브 검증되었습니다.

• 라이선스: MIT 라이선스. Resonite 커뮤니티를 위해 정성을 담아 만들었습니다.