Unity MCP Server
An MCP server for Unity: control the scene, objects, components, builds and profiling from an agent
- 542 ★ on the repository
- Last commit
Extended access
Why this level
- Controls the Unity editor and changes your project
- Runs builds and can install editors through Unity Hub
Install
- Works in
Manual install
git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git
cd unity-mcp-server
npm installInstall the server from source. The companion plugin is installed in Unity separately via Package Manager.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Controls the Unity editor and changes your project
- Runs builds and can install editors through Unity Hub
This is third-party code. Review the repository files before installing.
What it does
The server links an agent to the Unity editor through a companion plugin installed as a UPM package by a git URL. The agent works with the scene and hierarchy, creates and edits GameObjects and components, manages lights, environment, skybox and baking, handles the project and its packages, configures and runs builds, and captures profiling and scene screenshots. Through Unity Hub it can list and install editors and modules. The server discovers running Unity instances and prompts a choice when several exist, and some tools activate only when the matching packages are present in the project.
Who it is for. For Unity game developers who want to control the editor and builds through an agent.
Good fit when
- You need to build a scene, objects and components from a description
- You need to configure and run a project build
- You need profiling or a scene screenshot from an agent
Not a fit when
- You have no Unity 2021.3 LTS or newer
- You cannot install the companion plugin via Unity Package Manager
Example request
Create a red cube at position 0, 2, 0, add a Rigidbody and show the scene hierarchyMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
UNITY_HUB_PATH- Path to the Unity Hub executable.
UNITY_BRIDGE_PORT- Editor bridge port, default 7890.
Limitations
You need Node.js 18 or newer, Unity 2021.3 LTS or newer and the unity-mcp-plugin companion installed via UPM. Bridge paths and ports are set through environment variables. The AnkleBreaker Open License requires attribution and forbids reselling the tool, while personal and educational use is exempt from attribution. Some tools work only when packages such as Amplify Shader Editor are installed.
How to disable. Remove the server entry from your MCP client config and remove the companion plugin from Unity via Package Manager.
FAQ
What must I install in Unity itself?
The unity-mcp-plugin companion via Unity Package Manager from a git URL. Editor tools do not work without it.
Are there license limits?
Yes, the license requires attribution and forbids reselling the tool. Personal and educational use is exempt from attribution.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server that connects an AI agent to the Unity Editor: scene, objects, packages and project resources
Control the Unity Editor from an agent over MCP: scenes and objects, C# scripts, assets, tests, profiling and builds
A Unity package: the Editor serves MCP over HTTP itself, and agents and the command line drive scenes, assets and builds
A Unity package with a local editor bridge: an agent drives scenes, prefabs, builds and tests over MCP
An MCP server inside the Unity Editor: the agent builds scenes and scripts, enters play mode and checks the game with screenshots
A Unity plugin with an MCP server, skills and CLI: the agent drives scenes, assets, scripts and tests in the Unity Editor
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Unity MCP Server (this card) | no | not required | 542 | |
| Unreal Engine Skills for Claude Code | yes | 1,957 | epic Games' official plugin that lets Claude Code drive a running | |
| 3dsmax-mcp | no | not required | 386 | an MCP server for Autodesk 3ds Max |
| Funplay MCP for Unity | no | not required | 290 | an MCP server inside the Unity Editor |
README in short
The README covers installing the companion plugin via UPM, installing the server from source with npm install and configuring the client via node src/index.js. It lists tool groups: scene, objects, components, lighting, project, builds, profiling, input and Unity Hub. It documents environment variables for paths and ports, version requirements and an optional package section. It notes the server and plugin are free and open under the AnkleBreaker Open License.