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를 통해 제공됩니다.

주요 특징

아바타 제어 : 아바타 매개변수 및 표현 조작
이동 제어 : 아바타의 직접적인 움직임과 방향
소통 : 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"             
      ]
    }
  }
}

사용 가능한 옵션

옵션	설명	기본	노트
`--websocket-port <port>`	웹소켓 포트	8765	WebSocket 통신을 위해
`--websocket-host <host>`	웹소켓 호스트	로컬호스트	WebSocket 통신을 위해
`--osc-send-port <port>`	OSC 송신 포트	9000	VRChat으로 보내기 위한 포트
`--osc-send-ip <ip>`	OSC가 IP를 보냅니다	127.0.0.1	VRChat으로 보낼 주소
`--osc-receive-port <port>`	OSC 수신 포트	9001	VRChat에서 수신하기 위한 포트
`--osc-receive-ip <ip>`	OSC 수신 IP	127.0.0.1	VRChat에서 수신할 주소
`--debug`	디버그 로깅 활성화	거짓	자세한 로그 출력
`--no-relay`	릴레이 서버 비활성화	거짓	릴레이 서버를 사용하지 않을 때

사용 가능한 MCP 도구

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

도구 이름	설명
`get_avatar_name`	현재 아바타의 이름을 검색합니다
`get_avatar_parameters`	사용 가능한 아바타 매개변수를 나열합니다.
`set_avatar_parameter`	특정 아바타 매개변수를 설정합니다
`set_emote_parameter`	아바타 이모티콘을 트리거합니다
`move_avatar`	아바타를 특정 방향으로 이동합니다
`look_direction`	아바타의 시야 방향을 제어합니다.
`jump`	아바타를 점프하게 만듭니다
`menu`	VRChat 메뉴를 전환합니다
`voice`	음성 기능을 전환합니다
`send_message`	VRChat 채팅창에 메시지를 보냅니다.

문제 해결

일반적인 문제

VRChat이 명령에 응답하지 않습니다
- VRChat 설정에서 OSC가 활성화되어 있는지 확인하세요.
- VRChat과 MCP 구성 간의 OSC 포트가 일치하는지 확인하세요.
- VRChat 및 Claude Desktop을 다시 시작하세요.
MCP 서버가 시작되지 않습니다
- Node.js 18+가 설치되어 있는지 확인하세요.
- 오류에 대한 명령줄 인수를 확인하세요
- 더 자세한 로그를 보려면 --debug 플래그로 실행해보세요.
- 직접 인수가 작동하지 않으면 npx vrchat-mcp-osc -- --debug 사용하세요.
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

VRChat MCP OSC

Integrations

VRChat MCP OSC

개요

주요 특징

시스템 요구 사항

Claude Desktop과 함께 사용

복제 및 npm 링크

Claude Desktop 구성

명령줄 옵션

사용 가능한 옵션

사용 가능한 MCP 도구

문제 해결

일반적인 문제

프로젝트 구조

개발

소스에서 빌드

특허

감사의 말

Related MCP Servers

MCP Media Generator

VRChat MCP Server

OmniMCP

Zulip MCP Server

New MCP Servers