german-krasnikov/unity-biome-mcp

**Control the Unity Editor from MCP-compatible AI clients or from chat inside Unity.**
Inspect scenes, edit GameObjects, run playtests, and capture results through structured tools.
Quick Start ·
Documentation ·
Comparison ·
Changelog
Quick Start
Requirements: Unity 6 (6000.0 or newer), Git 2.14+ on PATH, and
uv. The MCP server does not need a separate Python
installation when it runs through uvx; optional Codex skill synchronization
requires Python 3.14 or newer on PATH. See the full
Getting Started prerequisites.
1. Install uv
macOS and Linux:
Windows:
2. Add the Unity package
1. In Unity, open **Window > Package Manager**.
2. Select **+ > Add package from git URL**.
3. Enter:
3. Configure your client
Open **MCP > Setup Wizard**, choose a client, and follow the result shown by the Wizard.
Configuration depends on the client. The Wizard may write a project configuration, run the configuration helper, copy a client-specific snippet, or defer configuration until In-Unity Chat starts. Restart the selected client when prompted. The Wizard configures the integration; it does not perform an end-to-end connection test.
Manual client setup guides
Use the matching guide:
Claude Code |
Claude Desktop |
Codex |
Cursor |
Junie |
Kimi |
OpenCode |
Rider AI Assistant |
VS Code |
Windsurf
For external OpenCode setup, do not use the Wizard's standard clipboard JSON:
OpenCode has a different configuration shape. Follow the
OpenCode guide.
4. Verify the first connection
For an external MCP client, keep the Unity project open, restart the client if
the Wizard asked you to, and send:
> Read the active Unity scene hierarchy at depth 2 and summarize its root objects.
The client should call:
A successful response contains the active scene hierarchy. If the call fails, open **MCP > Status > Diagnose** in Unity. For Chat-only verification, use the
Chat quick check. For command-line diagnostics, run:
See Getting Started for recovery steps and platform details.
Local development installation
Requirements for a source checkout: Git and Python 3.14 or newer.
> **Upgrading from older Python:** Install Python 3.14 via brew install python@3.14 (macOS), your system package manager (Linux), or python.org (Windows). Then run python install.py update to recreate the virtual environment.
The configuration helper supports claude-code, claude-desktop, cursor,
windsurf, vscode, codex, kimi, junie, and opencode.
Documentation
| Goal | Guide |
|---|---|
| Install and connect | Getting Started |
| Choose and configure an MCP client | Client guides |
| Install project-local AI guidance | AI Skills and Agents |
| Find a tool for a task | Tool Guide |
| Use batch safely | Batch Operations |
| Build Play Mode workflows | PlayTest DSL |
| Configure In-Unity Chat | Chat Backends |
| Extend Unity Biome MCP | Plugin Quick Start |
| Diagnose failures | Diagnostics |
What You Can Do
- **Scene and object editing:** inspect and modify GameObjects, components,
assets, materials, shaders, and UI.
- **Playtesting and verification:** run PlayTest DSL workflows, compile checks,
console checks, runtime diagnostics, and visual comparisons.
- **Animation and VFX:** work with clips, Animator controllers, Timeline,
particles, materials, shaders, and Shader Graph.
- **Efficient tool use:** group compatible operations with batch, request