# Unity MCP Pro

> 145 AI-powered tools connecting Claude, Cursor, and AI assistants to the Unity editor via the Model Context Protocol (MCP).

## Overview

Unity MCP Pro is an MCP server that gives AI assistants real-time access to the Unity editor through a WebSocket connection. The AI can create scenes, manage GameObjects, edit C# scripts, set up physics, configure lighting, animate, build players, manage prefabs, generate terrain, add particles, handle audio, create UI, simulate input, capture screenshots, run tests, and more — all from a single conversation with full Undo/Redo support.

## Architecture

AI Assistant <--stdio/MCP--> Node.js Server (TypeScript) <--WebSocket:6605--> Unity Editor Plugin (C#)

The Unity plugin runs a WebSocket server inside the editor. The MCP server connects to it and translates MCP tool calls into editor commands. All mutations go through Unity's Undo system. Features heartbeat monitoring, exponential backoff auto-reconnect, and port scanning (6605-6609).

## 145 Tools across 24 Categories

- Project (7): project info, project settings, asset tree, asset search, search in files, set project setting, resource preview
- Scene (6): hierarchy, create/open/save scene, play/stop scene
- GameObject (11): add/delete/rename, get/update/add components, set transform, duplicate, move, select, find
- Script (6): list/read/create/edit scripts, attach to GameObjects, compilation errors
- Editor (5): console logs, clear console, refresh AssetDatabase, execute menu item, performance monitors
- Prefab (6): create/instantiate/inspect/apply overrides/revert overrides/unpack
- Material & Shader (6): create material, get/set properties, assign material, list/create shaders
- Physics (6): colliders, rigidbodies, physics layers, collision matrix, raycasts, joints
- Lighting (5): lights, lighting settings, skybox, bake lighting, reflection probes
- Animation (7): animation clips, keyframes, clip info, animator controllers, states, transitions, parameters
- UI (6): canvas, UI elements, rect transform, text, images, layouts
- Audio (5): audio sources, clips, mixer info, mixer params, listeners
- Particle (5): particle systems, modules, info, sub-emitters, renderers
- Navigation (5): NavMesh baking, agents, obstacles, off-mesh links, NavMesh info
- Terrain (4): create terrain, heightmaps, terrain layers, trees
- Build Pipeline (5): build settings, build scenes, build player, scripting defines (get/set)
- Batch Operations (6): rename, set layer, set tag, set static, add component, batch execute
- Package Manager (4): list/add/remove/search packages
- Analysis & Profiling (10): scene statistics, missing references, unused assets, dependencies, memory, script analysis, script references, circular dependencies, project statistics, scene complexity
- Debug (5): play state, runtime inspection, method calls, find by type, debug log injection
- Input Simulation (8): simulate key/mouse/axis, get input state, simulate sequence, start/stop recording, replay recording
- Screenshot & Visual (4): editor screenshot, game screenshot, compare screenshots, capture frames
- Runtime Extended (7): monitor properties, execute editor/game scripts, find UI elements, click button by text, wait for node, find nearby objects
- Testing & QA (6): run tests, run test scenario, assert node state, assert screen text, stress test, test report

## Key Differentiators

- Full Undo/Redo on every operation (Ctrl+Z reverts AI changes)
- Production-grade WebSocket with heartbeat and auto-reconnect
- Smart Type Parsing (Vector3, Color, Quaternion, LayerMask)
- Complete Prefab workflow (no competitor has this)
- Build Pipeline integration (scene to executable)
- Terrain generation tools
- Runtime debugging in Play Mode
- Project analysis and profiling
- Input simulation and recording/replay
- Screenshot capture and visual comparison
- Testing & QA automation
- Compilation error feedback for AI self-correction

## Requirements

- Unity 2021.3+ (tested on Unity 6, works with 2022 and 2023)
- Node.js 18+
- Any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, VS Code + Cline, Windsurf)

## Setup

1. Import plugin into your Unity project (Package Manager or copy to Assets)
2. Build MCP server: cd server && npm install && npm run build
3. Add to .mcp.json: {"mcpServers": {"unity-mcp-pro": {"command": "node", "args": ["/path/to/server/build/index.js"]}}}

## Pricing

$8 one-time purchase. Lifetime updates. Unlimited projects and machines. Source code included.

## Links

- Website: https://unity-mcp.abyo.net/
- Buy (itch.io): https://y1uda.itch.io/unity-mcp-pro
- Buy (BMC): https://buymeacoffee.com/y1uda
- GitHub: https://github.com/youichi-uda/unity-mcp-pro-plugin
- Discord: https://discord.gg/9ccwueac