# Unity MCP

Hosts an MCP endpoint directly inside Unity Editor to inspect logs and modify project scenes directly from your AI agent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 335
- Author: isuzu-shiranui
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/isuzu-shiranui/UnityMCP
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/isuzu-shiranui-unity-mcp

## What it does

Rather than running an external bridge process, the server executes directly within Unity Editor at `http://127.0.0.1:<port>/mcp`. Companion terminal tasks run via `isuzu-unity-cli`, which ships as a native binary without requiring Node or .NET runtimes. Authoring tool operations group their changes so that each agent call maps to a single Undo step in the editor history.

The integration requires Unity Editor 2022.3 or newer. You also need Git 2.14.0 or later in your `PATH` when importing via the Unity Package Manager git URL, whereas VPM installations avoid Git entirely. Because the endpoint binds strictly to `127.0.0.1` and checks bearer tokens on incoming requests, remote network access to your editor session is blocked by design.

## Requirements
- Environment variables: `UNITY_MCP_STATE_DIR`, `UNITY_MCP_HOST` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- 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 editor console logs and compilation status
- modify game objects, scenes, and prefabs with automatic Undo
- execute EditMode unit tests and parse failure reports
- simulate keyboard and mouse input inside Unity Editor

## Example prompts
- Check Unity compilation errors and fix the syntax issue in the player controller script.
- Create a prefab with a BoxCollider component in the active scene.
- Run the test suite via Unity MCP and summarize failing assertions.

## 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