VRChat MCP OSC
by Krekun
VRChat MCP OSC bridges AI assistants and VRChat using the Model Context Protocol (MCP), enabling AI-driven avatar control and interactions. It allows AI to control avatar parameters, send messages, and respond to VR events.
Last updated: N/A
What is VRChat MCP OSC?
VRChat MCP OSC is a tool that uses OSC (Open Sound Control) to allow AI assistants, like Claude, to interact with and control aspects of VRChat avatars and the VRChat environment through the Model Context Protocol (MCP).
How to use VRChat MCP OSC?
To use VRChat MCP OSC, clone the repository, install dependencies using npm link, and configure Claude Desktop by editing the claude_desktop_config.json file. Command-line options are available to customize WebSocket and OSC ports. Ensure OSC is enabled in VRChat.
Key features of VRChat MCP OSC
Avatar Control
Movement Control
Communication
Menu Access
Avatar Information
Seamless VRChat Integration
Use cases of VRChat MCP OSC
AI-driven avatar expression control
Automated in-world messaging
AI-controlled avatar movement
Interactive VR experiences with AI
Dynamic avatar parameter adjustments based on AI input
FAQ from VRChat MCP OSC
VRChat not responding to commands?
VRChat not responding to commands?
Ensure OSC is enabled in VRChat settings, check that the OSC ports match between VRChat and MCP configuration, and restart VRChat and Claude Desktop.
MCP server not starting?
MCP server not starting?
Ensure Node.js 18+ is installed, check command line arguments for errors, try running with --debug flag for more detailed logs, and use npx vrchat-mcp-osc -- --debug if direct arguments don't work.
NPX execution issues?
NPX execution issues?
If arguments aren't being recognized, try using the double dash format: npx vrchat-mcp-osc -- --debug. On Windows, try running in a command prompt with administrator privileges. If you're having trouble with global installation, try the local npm link approach.
What is the Model Context Protocol (MCP)?
What is the Model Context Protocol (MCP)?
MCP is a standardized AI interface that allows AI assistants to interact with virtual environments and applications.
What are the system requirements?
What are the system requirements?
Node.js 18 or higher, VRChat with OSC enabled, and Claude Desktop (with MCP support).