# Unity MCP Pro

> 280+ 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 + Unity plugin 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, work with timelines, splines, ECS, netcode, XR, shader graphs, 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 client inside the editor that connects to the MCP server on 127.0.0.1:6605-6609. The MCP server translates MCP tool calls into editor commands. All mutations go through Unity's Undo system. Features heartbeat monitoring, exponential backoff auto-reconnect, and multi-port scanning.

## 280+ Tools across 52 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
- Animation Extended (5): blend trees, animation layers, avatar masks, rigging
- 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 (6): list/add/remove/search packages, import unitypackage, list asset store cache
- 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
- 2D Tools (6): 2D colliders, tilemaps, sprite renderers, sprite atlas, 2D physics setup
- Controller (4): FPS, TPS, platformer, character controllers
- Environment (6): wind zones, fog settings, weather system, volumes, lighting presets, visual presets
- Timeline (5): create timeline, add tracks/clips, bind tracks
- Optimization (7): suggest optimizations, LOD groups, mesh optimization, draw call analysis, overdraw, texture analysis
- Camera / Cinemachine (6): cinemachine cameras, follow, aim, camera paths
- Post-Processing (5): volume profiles, volume effects, render pipeline settings
- AI Tools (4): AI agents, state machines, patrol routes, waypoints
- Game Systems (5): health, inventory, spawn, dialogue, interaction systems
- Shader Graph (5): create/edit shader graphs, add/connect nodes
- Visual Scripting (5): visual scripts, nodes, connections, variables
- Profiler (4): profiler data, capture, frame analysis, summary
- Import Settings (5): texture/model/audio import settings, presets
- Spline (5): create splines, add knots, extrude mesh, spline info
- Multi-Scene (4): additive loading, active scene, unload, loaded scenes
- Scene View (4): camera control, alignment, frame objects, get camera
- Playthrough (4): automated playthrough scenarios, results
- Benchmark (4): benchmark profiles, run benchmarks, compare, history
- Watch (3): live property monitoring, get values, unwatch
- Addressables (5): groups, addresses, info, analysis, build
- Localization (4): string tables, locale entries, project locale
- Custom Editor (4): custom inspectors, property drawers, editor windows, scriptable wizards
- Undo (3): undo history, perform undo/redo
- Rigging (4): rig constraints, IK, avatar masks, rig layers
- ECS / DOTS (4): ECS components, systems, authoring, info
- Netcode (4): network manager, network objects, behaviours, info
- XR / VR (4): XR setup, interactables, controllers, info

## 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)
- Built-in Server Setup window for easy configuration
- Complete Prefab workflow
- 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
- 52 categories covering virtually every Unity subsystem

## 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, Windsurf, Codex CLI)

## Setup

1. Import plugin into your Unity project (Package Manager or copy to Assets)
2. Open Window → Unity MCP Pro → Server Setup
3. Click Install Dependencies and copy IDE configuration

## Pricing

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

## Links

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