AnkleBreaker-Studio/unity-mcp-server

Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, animation, MPPM multiplayer & more. Free & open source by AnkleBreaker Studio.

362 ★46 forksJavaScriptUpdated 10d ago

What you need to know

The most comprehensive MCP server for Unity game development — 330+ tools across 30+ categories bridging AI assistants (Claude, Cursor, Windsurf, any MCP client) to Unity Editor and Unity Hub via a companion Unity plugin that runs an HTTP bridge inside the editor.

Install

Unity: Window > Package Manager > + > Add package from git URL: https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git
git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git && cd unity-mcp-server && npm install
npx anklebreaker-unity-mcp@latest   # npm package (renamed from unity-mcp-server)

Usage

  • Add to Claude Desktop config with `node C:/path/to/unity-mcp-server/src/index.js` and set UNITY_HUB_PATH and UNITY_BRIDGE_PORT (default 7890); restart Claude Desktop.
  • Ask the AI to manage the editor: "Show me the scene hierarchy", "Create a red cube at (0,2,0) and add a Rigidbody", "Profile my scene", "Build my project for Windows", "List and start my MPPM multiplayer scenarios".
  • Core tools (~70) are always exposed; advanced tools (254) are accessed via `unity_advanced_tool` proxy with lazy loading — use `unity_list_advanced_tools` to discover them.

Key features

  • 330+ tools across 30+ categories: Unity Hub control, scenes, GameObjects, components, assets, C# scripts, multi-platform builds, console/compilation errors, EditMode/PlayMode tests, physics, terrain, NavMesh, lighting, audio, particles, animation, Shader Graph, Amplify Shader Editor, Profiler/Frame Debugger/Memory Profiler, MPPM multiplayer, ProBuilder.
  • Two-tier tool system to stay within MCP client tool limits while exposing all 330+ tools on demand.
  • Multi-instance support (auto-discovers running editors, port identity validation, crash detection via heartbeat) and multi-agent support (session tracking, action logs, queued execution).
  • Optional-package tools auto-activate when detected (memoryprofiler, shadergraph, visualeffectgraph, inputsystem, multiplayer.playmode, Amplify Shader Editor, UMA 2).
  • Free and open source (AnkleBreaker Open License); works with any MCP-compatible client.

Best for

AI-assisted Unity game development — letting Claude/Cursor/Windsurf drive the Unity Editor end-to-end (scene building, debugging, profiling, building) including against competitors like Bezi and Coplay MCP.

Caveats

  • Requires Node.js 18+, Unity Hub (for Hub tools), and the companion unity-mcp-plugin installed in the Unity Editor — supports Unity 2021.3 LTS and newer.
  • `unity_screenshot_editor_window` is Windows-editor only; on macOS/Linux it returns an unsupported-platform message.
  • AnkleBreaker Open License: attribution required in products built with it ("Made with AnkleBreaker MCP"), and reselling the tool is forbidden.
  • The MCP server and plugin are free; the only cost is your AI assistant subscription (e.g., Claude Pro).
Platforms: Windows · macOS · LinuxClients: Claude Desktop · Claude Cowork · Cursor · Windsurf · Codex CLI · Any MCP client

Reviewed 2026-08-07

Topics

aiai-assisted-developmentai-game-developmentamplify-shader-editoranklebreakerclaudeclaude-desktopgame-developmentgamedevmcpmcp-servermodel-context-protocolopen-sourceshader-graphunityunity-editorunity-hubunity-mcpunity-pluginunity3d
View on GitHub ↗
Stars
362★
Forks
46
Language
JavaScript
License
NOASSERTION
Created
2026-02-25
Last push
2026-07-27