VRChat MCP OSC
**VRChat MCP OSC** provides a bridge between AI assistants and VRChat using the Model Context Protocol (MCP), enabling AI-driven avatar control and interactions in virtual reality environments.
Overview
By leveraging OSC (Open Sound Control) to communicate with VRChat, **VRChat MCP OSC** allows AI assistants such as Claude to:
- Control avatar parameters and expressions
- Send messages in VRChat
- Respond to various VR events And more all through the high-level API provided by the Model Context Protocol.
Key Features
- **Avatar Control**: Manipulate avatar parameters and expressions
- **Movement Control**: Direct avatar movement and orientation
- **Communication**: Send messages through VRChat's chatbox
- **Menu Access**: Toggle VRChat menu and interface elements
- **Avatar Information**: Query avatar properties and parameters
- **Seamless VRChat Integration**: Automatic detection of avatar configurations
System Requirements
- Node.js 18 or higher
- VRChat with OSC enabled
- Claude Desktop (with MCP support)
Using with Claude Desktop
Clone and npm link
Configure Claude Desktop
Configure Claude Desktop by editing the `claude_desktop_config.json` file:
Command Line Options
The server supports various command-line arguments for customization:
Available Options
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] | [object Object] |
Available MCP Tools
VRChat MCP OSC exposes the following MCP tools to AI assistants:
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
Troubleshooting
Common Issues
- **VRChat not responding to commands** - Ensure OSC is enabled in VRChat settings - Check that the OSC ports match between VRChat and MCP configuration - Restart VRChat and Claude Desktop
- **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 - Use `npx vrchat-mcp-osc -- --debug` if direct arguments don't work
- **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
Project Structure
Development
Build From Source
License
VRChat MCP OSC is dual-licensed as follows:
For Non-Commercial Use:
You may use, modify, and redistribute the software under the terms of the MIT License.
(See the MIT License file for details.)
For Commercial Use:
Commercial use of this software requires a separate commercial license.
By using this software under the MIT License for non-commercial purposes, you agree to the terms of that license. Commercial users must obtain a commercial license as described above.
Acknowledgments
- VRChat team for the OSC integration
- Model Context Protocol for the standardized AI interface
- Anthropic for Claude's MCP implementation