A
securityF
licenseA
qualityEnables AI assistants to interact with Figma files through the ModelContextProtocol, allowing viewing, commenting, and analyzing Figma designs directly in chat interfaces.
Last updated -
5
631
206
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"
]
}
}
}
사용 가능한 옵션
옵션 | 설명 | 기본 | 노트 |
| 웹소켓 포트 | 8765 | WebSocket 통신을 위해 |
| 웹소켓 호스트 | 로컬호스트 | WebSocket 통신을 위해 |
| OSC 송신 포트 | 9000 | VRChat으로 보내기 위한 포트 |
| OSC가 IP를 보냅니다 | 127.0.0.1 | VRChat으로 보낼 주소 |
| OSC 수신 포트 | 9001 | VRChat에서 수신하기 위한 포트 |
| OSC 수신 IP | 127.0.0.1 | VRChat에서 수신할 주소 |
| 디버그 로깅 활성화 | 거짓 | 자세한 로그 출력 |
| 릴레이 서버 비활성화 | 거짓 | 릴레이 서버를 사용하지 않을 때 |
사용 가능한 MCP 도구
VRChat MCP OSC는 다음과 같은 MCP 도구를 AI 어시스턴트에 제공합니다.
도구 이름 | 설명 |
| 현재 아바타의 이름을 검색합니다 |
| 사용 가능한 아바타 매개변수를 나열합니다. |
| 특정 아바타 매개변수를 설정합니다 |
| 아바타 이모티콘을 트리거합니다 |
| 아바타를 특정 방향으로 이동합니다 |
| 아바타의 시야 방향을 제어합니다. |
| 아바타를 점프하게 만듭니다 |
| VRChat 메뉴를 전환합니다 |
| 음성 기능을 전환합니다 |
| 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 -- --debugWindows에서는 관리자 권한으로 명령 프롬프트에서 실행해보세요.
글로벌 설치에 문제가 있는 경우 로컬 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
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.Last updated -181746MIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -62
- -securityAlicense-qualityAllows users to integrate their custom Quickchat AI Agents into various AI applications (Claude Desktop, Cursor, VS Code, etc.) through the Model Context Protocol, enabling AI-to-AI interactions.Last updated -21MIT License