# Unity AI Bridge

Lets an AI agent work inside the Unity Editor: scenes, objects, assets, profiler and tests, over file-based IPC with no ports to open.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 23
- Author: butterlatte-zhang
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/butterlatte-zhang/unity-ai-bridge
- Updated: 2026-03-25
- HTML: https://affpapa.org/en/nevibecode/mcp/unity-ai-bridge

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Works with: Unity

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- Open the `Main` scene and list the components on `Player`.
- Capture a profiler snapshot and tell me which method takes the most time.
- Make a prefab from `Enemy` and save it under `Assets/Prefabs`.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md