Unity Biome MCP

by german-krasnikov

Not rated
GitHub

Description

Control Unity Editor from MCP clients or from chat inside Unity — 70+ tools for scenes, GameObjects, components, assets, Shader Graph, PlayTest DSL, screenshots with visual diff, batch operations, and token-efficient protocol. 11,700+ tests, cross-platform CI, Setup Wizard for…

About

Control Unity Editor from MCP clients or from chat inside Unity — 70+ tools for scenes, GameObjects, components, assets, Shader Graph, PlayTest DSL, screenshots with visual diff, batch operations, and token-efficient protocol. 11,700+ tests, cross-platform CI, Setup Wizard for 10 clients.

Details

Author
german-krasnikov
Categories
Developer Tools, Other

Setup

Install Unity Biome MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/german-krasnikov/unity-biome-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

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

Requirements: Unity 6 (6000.0or newer), Git 2.14+ onPATH, anduv. The MCP server does not need a separate Python installation when it runs throughuvx; optional Codex skill synchronization requires Python 3.14 or newer onPATH. See the fullGetting Started prerequisites.

curl -LsSf https://astral.sh/uv/install.sh | sh

- In Unity, openWindow > Package Manager.
- Select+ > Add package from git URL.
- Enter:

https://github.com/german-krasnikov/unity-biome-mcp.git?path=unity-plugin

OpenMCP > 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.

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 theOpenCode guide.

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.

A successful response contains the active scene hierarchy. If the call fails, openMCP > Status > Diagnosein Unity. For Chat-only verification, use theChat quick check. For command-line diagnostics, run:

uvx --from git+https://github.com/german-krasnikov/unity-biome-mcp.git#subdirectory=server unity-biome-mcp doctor

SeeGetting Startedfor recovery steps and platform details.

Requirements for a source checkout: Git and Python 3.14 or newer.

Upgrading from older Python:Install Python 3.14 viabrew install python@3.14(macOS), your system package manager (Linux), orpython.org(Windows). Then runpython install.py updateto recreate the virtual environment.

git clone https://github.com/german-krasnikov/unity-biome-mcp.git cd unity-biome-mcp python install.py setup python install.py configure --tool claude-code python install.py doctor

The configuration helper supportsclaude-code,claude-desktop,cursor,windsurf,vscode,codex,kimi,junie, andopencode.

- 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 withbatch, request deferred schemas, and enable capability categories only when needed.
- Extensibility:add project-specific server tools, Unity commands, Chat context chips, and plugin hooks.

Create a player object, add a Rigidbody, and place it at the scene origin.

Find enemies without colliders and add a BoxCollider to each.

Run a playtest that moves the player to the door and verifies that the score increases.

Capture the Game View and compare it with the saved baseline.

Summarize scene changes since the last checkpoint.

Usebatchfor two or more compatible operations:

batch(commands=""" create_object name=Enemy set_property path=Enemy component=Transform prop=position value=0,1,0 manage_component path=Enemy type=Rigidbody action=add set_property path=Enemy component=Rigidbody prop=mass value=2 """)

Some typed tools are direct-only and cannot be placed in a batch. See theBatch guidefor validation, Undo-backed rollback, and error handling.

An MCP client launches the Python server over stdio. The server discovers the active Unity project and sends framed commands to the editor plugin over localhost TCP.

OpenMCP > Chatto work inside the editor. Select a supported CLI backend and use Ask or Agent mode. Authentication is handled by the selected CLI. Context chips can attach scene objects, scripts, and assets to a turn, while each completed AI turn is grouped for Unity undo.

SeeChat backendsfor setup and behavior.

The external path isMCP client -> Python MCP server -> localhost TCP -> Unity Editor plugin. In-Unity Chat invokes the selected CLI through the local chat relay; that CLI connects to the same Python MCP server and rejoins the shared TCP-to-plugin path.

The Unity package includes 12 reusable domain skills and 4 focused agents for Claude Code and Codex. They cover efficient MCP tool selection, batching, Unity authoring, playtesting, diagnostics, and evidence-based verification.

OpenMCP > Install AI Skillsto install them into the current project. Existing and generated files are ownership-checked before replacement. SeeAI Skills and Agentsfor paths, safe updates, and Codex synchronization.

The values below are generated from registrations, pytest collection, Unity test discovery or source scanning, and package metadata. They are discovery counts, not a claim that every test was executed in the current checkout.

- Unity Biome MCP:160 registered tools, deterministic PlayTest DSL, and visual baseline/diff workflows.
- Unity MCP Server 2.17:first-party local bridge, connection approval, and multi-client support.
- MCP for Unity 10.1.2:Unity 2021.3 compatibility, 47 tool entrypoints, and authenticated remote hosting.
- AI Game Developer 0.87.0:compiled-player runtime plus local, HTTP, cloud, and Docker deployment.
- MCP Unity:33 listed tools, optional Undo rollback for batches, and an MCP App dashboard.

The detailed matrix cites exact source commits or versioned official documentation and records constraints as well as strengths.

Current release: v1.46.0 (2026-08-20).Read the full changelog.

ReadCONTRIBUTING.mdbefore opening a pull request. New contributors can start withgood first issues.

Report security issues throughSECURITY.md.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server for Unity, enabling AI assistants to interact with projects in real-time, access scene data, and execute code.

Manipulate Adventure Game Studio (AGS) compiled room (.crm) files to enable AI-powered game development.

Godot Engine integration: 17 tools for game development

An MCP server for AI coding assistants to control, inspect, and modify Bevy applications using the Bevy Remote Protocol (BRP).

Control, inspect, and mutate Bevy applications with AI coding assistants via the Bevy Remote Protocol (BRP).

A server for Ebitengine games that provides debugging and recording tools by capturing game state.

Fennara MCP connects AI agents like Codex, Cursor, Claude Code, and Claude Desktop to Godot-aware tools for real Godot projects. It focuses on feedback from Godot: GDScript diagnostics, scene validation, runtime errors, scene inspection, node properties, screenshots, SemanticSearch, and patch-and-rerun workflows.

an open-source MCP server that unifies Roblox Studio, Unity, Unreal Engine, and Blender into a single AI control plane for game development workflows.

7 tools for 3D game development — character viewers, level editors, physics games, particle effects, 3D inventories with SceneView. 156 tests.

The intelligent MCP server for AI-assisted Godot 4 development. 35 tools for spatial intelligence, code understanding, flow tracing, and visual debugging. 22 free, full suite $19.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.