Unity MCP Pro — Plugin
Unity editor plugin that connects AI assistants (Claude, Cursor, Windsurf, VS Code Copilot) to the Unity editor via WebSocket.
280+ tools across 50 categories — scene management, GameObjects, scripts, prefabs, physics, lighting, animation, materials, terrain, particles, audio, UI, build pipeline, input simulation, screenshots, testing, 2D, timeline, splines, ECS, netcode, XR, and more.
Features
- Full Undo/Redo — Every AI operation goes through Unity's Undo system (Ctrl+Z)
- Production-grade WebSocket — Heartbeat, auto-reconnect with exponential backoff, port scanning (6605–6609)
- Smart Type Parsing — Automatic conversion of strings to Vector3, Color, Quaternion, etc.
- Domain Reload Safe — Survives script recompilation without losing connection state
- Server Setup Window — Built-in editor window for configuring MCP server and IDE integration
- Unity 2021.3+ — Supports Unity 2022, 2023, and Unity 6 (Built-in, URP, HDRP)
50 Tool Categories
Installation
Option 1: Unity Package Manager (Git URL)
- Open Unity → Window → Package Manager
- Click + → Add package from git URL...
- Enter:
https://github.com/youichi-uda/unity-mcp-pro-plugin.git
Option 2: Clone to your project
cd YourUnityProject/Packages
git clone https://github.com/youichi-uda/unity-mcp-pro-plugin.git com.unity-mcp-pro
Option 3: Download and copy
Download this repository and copy it into your project's Packages/com.unity-mcp-pro/ directory.
Setup
This plugin is the Unity-side component of Unity MCP Pro. To use it with AI assistants, you also need the MCP server.
- Install this plugin (see above)
- Get the MCP server — Available at unity-mcp.abyo.net
- Build the MCP server:
cd server && npm install && npm run build - Configure your AI client (or use the built-in Window → Unity MCP Pro → Server Setup):
{ "mcpServers": { "unity-mcp-pro": { "command": "node", "args": ["/path/to/server/build/index.js"] } } } - Open Unity — The plugin auto-connects when the editor starts. Check Window → Unity MCP Pro for connection status.
Architecture
AI Assistant ←—stdio/MCP—→ Node.js MCP Server ←—WebSocket—→ Unity Editor Plugin (this repo)
The plugin runs a WebSocket client inside the Unity editor that connects to the MCP server on 127.0.0.1:6605–6609. All tool calls are dispatched through the CommandRouter to domain-specific command handlers.
Multi-Editor Support
Run multiple Unity editors simultaneously on ports 6605-6609. Set the UNITY_MCP_PORT environment variable to target a specific instance.
Running Tests
- Open Unity → Window → General → Test Runner
- Select EditMode tab
- Click Run All
Requirements
- Unity 2021.3 LTS or later
- Node.js 18+ (for the MCP server)
- Any MCP-compatible AI client
Links
- Website
- Unity Asset Store — AI Bridge for Unity (MCP Pro)
- MCP Server (itch.io)
- Discord
License
MIT License — see LICENSE
