Unity AI Bridge — Claude Code MCP server for Unity Editor control
Lets an AI agent work inside the Unity Editor: scenes, objects, assets, profiler and tests, over file-based IPC with no ports to open.
Open on GitHubWhat Unity AI Bridge does
The setup has two halves. A Unity package (com.aibridge.unity) polls files on disk, and a Python script on the AI side answers them. Skill mode uses bridge.py; MCP mode uses mcp_server.py. Nothing listens on a socket, so a script recompile or a play-mode switch does not kill the link.
The plugin exposes 65 tools in 15 categories, from scene and GameObject editing to prefab handling, script execution, profiler snapshots, light probe baking, test runs and package management. Want another tool? Write a method with the [BridgeTool] attribute and it gets picked up without registration code. The Unity side needs 2022.3 LTS or newer.
Install order matters: add the package from its git URL in Package Manager, then drop .claude/ into the project root and configure the IDE as docs/SETUP.md describes. Drop the config step and the agent never learns the bridge exists.
What it helps with
- inspect the open scene and change a named object
- turn a scene object into a saved prefab
- profile a frame and surface the hot method
- bake light probes across a level grid
- run the project test suite and hand back results
Example prompts for the agent
- Open the
Mainscene and list the components onPlayer. - Capture a profiler snapshot and tell me which method takes the most time.
- Make a prefab from
Enemyand save it underAssets/Prefabs.
How to install Unity AI Bridge
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Unity AI Bridge
How do I install Unity AI Bridge in Claude Code?
Add the package in Unity via Package Manager: + → Add package from git URL → https://github.com/butterlatte-zhang/unity-ai-bridge.git?path=Packages/com.aibridge.unity. Then copy .claude/ into your project root and follow docs/SETUP.md for the IDE side.
What does Unity AI Bridge do?
It gives an AI agent control of the Unity Editor: open and save scenes, edit GameObjects and components, manage assets and prefabs, run tests, take profiler snapshots. Requests travel as files rather than over a network connection.
Which Unity versions does it support?
2022.3 LTS and up. Unity shipped its own AI Gateway only in 6.2, so on 2022.3 LTS this plugin is the option that works.
