VRChat MCP OSC

VRChat MCP OSC는 MCP(모델 컨텍스트 프로토콜)를 사용하여 AI 어시스턴트와 VRChat을 연결하여 가상 현실 환경에서 AI 기반 아바타 제어 및 상호 작용을 구현합니다.

개요

VRChat MCP OSC는 OSC(Open Sound Control)를 활용하여 VRChat과 통신함으로써 Claude와 같은 AI 보조원이 다음을 수행할 수 있도록 지원합니다.

• 아바타 매개변수 및 표현식 제어

• VRChat에서 메시지 보내기

• 다양한 VR 이벤트에 대응
  그리고 더 많은 기능은 Model Context Protocol이 제공하는 고수준 API를 통해 제공됩니다.

Related MCP server: VRChat MCP Server

주요 특징

• 아바타 제어 : 아바타 매개변수 및 표현 조작

• 이동 제어 : 아바타의 직접적인 움직임과 방향

• 소통 : VRChat 채팅창을 통해 메시지 보내기

• 메뉴 접근 : VRChat 메뉴 및 인터페이스 요소 전환

• 아바타 정보 : 아바타 속성 및 매개변수 쿼리

• 원활한 VRChat 통합 : 아바타 구성 자동 감지

시스템 요구 사항

• Node.js 18 이상

• OSC가 활성화된 VRChat

• Claude Desktop(MCP 지원)

Claude Desktop과 함께 사용

복제 및 npm 링크

지엑스피1

Claude Desktop 구성

claude_desktop_config.json 파일을 편집하여 Claude Desktop을 구성합니다.

{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc"
      ]
    }
  }
}

명령줄 옵션

서버는 사용자 정의를 위한 다양한 명령줄 인수를 지원합니다.

# Claude Desktop configuration
{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc",
        "--websocket-port", "8765",
        "--websocket-host", "localhost",
        "--osc-send-port", "9000",
        "--osc-send-ip", "127.0.0.1",
        "--osc-receive-port", "9001",
        "--osc-receive-ip", "127.0.0.1",
        "--debug"             
      ]
    }
  }
}

사용 가능한 옵션

사용 가능한 MCP 도구

VRChat MCP OSC는 다음과 같은 MCP 도구를 AI 어시스턴트에 제공합니다.

문제 해결

일반적인 문제

1. VRChat이 명령에 응답하지 않습니다

   • VRChat 설정에서 OSC가 활성화되어 있는지 확인하세요.

   • VRChat과 MCP 구성 간의 OSC 포트가 일치하는지 확인하세요.

   • VRChat 및 Claude Desktop을 다시 시작하세요.

2. MCP 서버가 시작되지 않습니다

   • Node.js 18+가 설치되어 있는지 확인하세요.

   • 오류에 대한 명령줄 인수를 확인하세요

   • 더 자세한 로그를 보려면 --debug 플래그로 실행해보세요.

   • 직접 인수가 작동하지 않으면 npx vrchat-mcp-osc -- --debug 사용하세요.

3. NPX 실행 문제

   • 인수가 인식되지 않으면 이중 대시 형식을 사용해 보세요: npx vrchat-mcp-osc -- --debug

   • Windows에서는 관리자 권한으로 명령 프롬프트에서 실행해보세요.

   • 글로벌 설치에 문제가 있는 경우 로컬 npm 링크 접근 방식을 시도해 보세요.

프로젝트 구조

vrchat-mcp-osc/
├── packages/
│   ├── mcp-server/    # MCP server implementation (main entry point)
│   ├── relay-server/  # WebSocket to OSC relay
│   ├── types/         # Shared TypeScript interfaces
│   └── utils/         # Common utilities
└── pnpm-workspace.yaml  # Workspace configuration

개발

소스에서 빌드

# Clone the repository
git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc

# Install dependencies
pnpm install

# Build all packages
pnpm -r build

# Development mode
pnpm -r dev

특허

VRChat MCP OSC는 다음과 같이 이중 라이센스를 받았습니다.

비상업적 사용: MIT 라이선스 조건에 따라 소프트웨어를 사용, 수정 및 재배포할 수 있습니다. (자세한 내용은 MIT 라이선스 파일을 참조하십시오.)

상업적 사용: 이 소프트웨어를 상업적으로 사용하려면 별도의 상업적 라이선스가 필요합니다.

비상업적 목적으로 MIT 라이선스에 따라 이 소프트웨어를 사용하는 경우, 해당 라이선스 조건에 동의하는 것으로 간주됩니다. 상업적 사용자는 위에 설명된 대로 상업적 라이선스를 취득해야 합니다.

감사의 말

• OSC 통합을 위한 VRChat 팀

• 표준화된 AI 인터페이스를 위한 모델 컨텍스트 프로토콜

• Claude의 MCP 구현을 위한 Anthropic