M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
U

Unity MCP Server

Community
330+ tools to turn Claude into a full Unity Editor & Hub copilot
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #258 of 438
Stars
★ 494 Very popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
No credential needed
License
Other / unspecified
Last commit
50FMRS · D

This is a feature-rich open-source Unity MCP server providing 330+ tools, the most comprehensive among competitors (compared to Bezi and Coplay MCP), and it's free. It's especially well-suited for developers using Claude Cowork, thanks to its two-tier tool system that optimizes tool list size. However, it requires environment configuration awareness and carries data manipulation risks, so backups are recommended.

Strongest · Documentation 15/20 Weakest · Reliability 4/20

Reliability
4/20
Security and permissions
6/20
Maintenance
12/20
Documentation
15/20
Setup experience
13/20
Why each score
Reliability 4/20
Only the README and repository metadata were supplied; no source code, tests, or CI configuration could be inspected. It is impossible to verify clean startup, the MCP init and tools/list handshake, or whether declared tools match real behavior. The README's claims of a 57-test harness and CI are untrusted evidence and cannot be credited; no server manifest was cached. Missing evidence forces a low score.
Security and permissions 6/20
No red-line issue is visible in the supplied material: no malware, credential theft, covert exfiltration, or real tokens in install examples. However, without the source it is impossible to verify credential handling, least privilege, network boundaries, or confirmation flows for dangerous operations such as C# execution, builds, and asset deletion. The README describes broad editor control through a local HTTP bridge, but no explicit confirmation or approval mechanism is documented, so security evidence is incomplete.
Maintenance 12/20
The repository is not archived, and the README documents active evolution from v2.28 to v2.35, an npm auto-publish action, and a low open-issue count. However, the license field is NOASSERTION and the custom AnkleBreaker Open License cannot be validated from available material; there is also no documented dependency-update or security-response channel. The project appears active but has governance and versioning gaps.
Documentation 15/20
The README is layered and detailed: installation, configuration table, troubleshooting, FAQ, platform limitations, and cost comparisons are all present with examples. Deductions are made for the lack of per-tool parameter reference, the uncached server manifest, inconsistent tool counts (268 in the title vs 330+ in the body), and the inability to cross-check claims against source files.
Setup experience 13/20
The quick start is clear and few-step: clone, npm install, add a JSON config to Claude Desktop, and install the companion Unity plugin via UPM; the environment-variable table is complete. However, setup depends on an external Unity plugin, no source or CI evidence proves out-of-box operation, and some features are Windows-only. Without verifiable execution evidence, the score is capped below 15.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessWrites / deletes local filesRuns commands or codeUses the network

Best for

  • Independent developers and small studios looking for a free, open-source solution to control Unity with AI
  • Developers who want to automate game development workflows using MCP-compatible clients like Claude or Cursor
  • Teams needing an extensive toolset covering a broad range of Unity features

Not for

  • Professional game companies requiring commercial support or enterprise guarantees
  • Beginners who are not comfortable with environment configuration or command-line tools (requires Node.js 18+ and Unity Hub)
  • Users who want to use Unity's native AI features within Unity 6.2+ without external MCP clients

Required permissions

  • Read/modify Unity project files, create/delete assets and scripts
  • Execute Unity Editor commands, read console and compilation logs
  • Control Unity Hub (list/install editors) requiring UNITY_HUB_PATH environment variable
  • Communicate with the Unity Editor over HTTP bridge, default port 7890

Risks and side effects

  • Data loss risk due to automatic creation/deletion of assets and scripts; recommend regular project backups
  • AI-generated code may introduce errors or corrupt the project
  • Misconfiguration of environment variables (e.g., UNITY_HUB_PATH) can cause connection failures
  • Using a non-standard license (AnkleBreaker Open License) might restrict commercial redistribution

Setup

Before you start

Runtime：Node.js 18+

Other optional settings (12)
UNITY_HUB_PATH optional Path to the Unity Hub executable; defaults to C:\Program Files\Unity Hub\Unity Hub.exe
UNITY_BRIDGE_HOST optional Editor bridge host; defaults to 127.0.0.1
UNITY_BRIDGE_PORT optional Editor bridge port; defaults to 7890, auto-discovered with multi-instance
UNITY_BRIDGE_TIMEOUT optional Request timeout in ms; defaults to 60000
UNITY_PORT_RANGE_START optional Start of port scan range for multi-instance discovery; defaults to 7890
UNITY_PORT_RANGE_END optional End of port scan range for multi-instance discovery; defaults to 7899
UNITY_REGISTRY_STALENESS_TIMEOUT optional Registry staleness timeout in ms used for crash detection; defaults to 300000
UNITY_RESPONSE_SOFT_LIMIT optional Response size soft limit in bytes (warning); defaults to 2097152
UNITY_RESPONSE_HARD_LIMIT optional Response size hard limit in bytes (truncation); defaults to 4194304
UNITY_MCP_DEBUG optional Set to 1 to append diagnostics to UnityMCP/mcp-debug.log (5MB rotation)
UNITY_MCP_PRETTY_JSON optional Set to 1 to pretty-print tool responses (default compact JSON saves 20-50% tokens)
UNITY_MCP_COMPACT_TOOLS optional Set to 1 for a minimal tools/list (~21KB) for clients with registry size limits
  1. Install the Unity plugin: Window > Package Manager > + > Add package from git URL: https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git 2. Clone and install the server: git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git && cd unity-mcp-server && npm install 3. Add the following JSON config to Claude Desktop (Settings > Developer > Edit Config): {"mcpServers":{"unity":{"command":"node","args":["C:/path/to/unity-mcp-server/src/index.js"],"env":{"UNITY_HUB_PATH":"C:\\Program Files\\Unity Hub\\Unity Hub.exe","UNITY_BRIDGE_PORT":"7890"}}}} 4. Restart Claude Desktop

Check that it works

After restarting Claude Desktop, unity core tools such as unity_list_instances should appear in the client's tool list; ask "List my installed Unity editors" — a returned editor list (with the Unity Console showing [MCP Bridge] Server started on port 7890) confirms the connection.

Troubleshooting

  1. Connection failed: Ensure Unity Editor is open and plugin installed; check console for '[MCP Bridge] Server started on port 7890'
  2. Unity Hub not found: Update UNITY_HUB_PATH in config to point to correct Unity Hub executable
  3. Port conflict: Change UNITY_BRIDGE_PORT and update the port in Unity's MCP Dashboard settings
  4. Category disabled: Check category settings in Unity's MCP Dashboard and enable the required category

Things to try

Once connected, you can ask your AI assistant things like:

  • List my installed Unity editors
  • Show me the scene hierarchy
  • Create a red cube at position (0, 2, 0) and add a Rigidbody
  • Build my project for Windows

Use cases

AI-assisted game development: create scenes, place objects, write scripts, run builds
Get scene hierarchy, view compilation errors, profile performance
Edit Shader Graphs, sculpt terrain, bake NavMesh, manage animations, run multiplayer tests

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

The AnkleBreaker Unity MCP server is the most comprehensive Model Context Protocol (MCP) server for Unity game development. It connects MCP-compatible AI assistants like Claude, Cursor, and Windsurf to Unity Editor and Unity Hub via an HTTP bridge. It provides 330+ tools across 30+ categories, including scene management, GameObjects, components, rendering, builds, profiling, Shader Graph, Amplify Shader Editor, terrain, physics, NavMesh, animation, multiplayer, assets, scripts, and testing. It uses a two-tier tool system: about 70 core tools are always exposed directly, while the remaining 254 are accessed via a unity_advanced_tool proxy with lazy loading to avoid overwhelming MCP clients. It supports multi-instance, multi-agent, port resilience, and crash detection. Fully free and open source under the AnkleBreaker Open License, but reselling is forbidden.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision 9c84ff9fe22d Data synced 2026-10-12 Read the FMRS scoring method