Unity MCP Plugin
Unity MCP Plugin (UPM) — Editor bridge for AI-assisted game development. Enables Claude, Cursor & MCP-compatible AI to control Unity Editor with 268 tools: scenes, GameObjects, components, builds, profiling, Shader Graph, Amplify Shader Editor, terra
What is Unity MCP Plugin?
Unity MCP Plugin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unity mcp plugin (upm) — editor bridge for ai-assisted game development. enables claude, cursor & mcp-compatible ai to control unity editor with 268 tools: scenes, gameobjects, components, builds, pro...
Unity MCP Plugin (UPM) — Editor bridge for AI-assisted game development. Enables Claude, Cursor & MCP-compatible AI to control Unity Editor with 268 tools: scenes, GameObjects, components, builds, profiling, Shader Graph, Amplify Shader Editor, terra
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Unity MCP Plugin (UPM) — Editor bridge for AI-assisted game
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx unity-mcp-pluginConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Unity MCP Plugin
Unity MCP Plugin is an editor bridge that lets AI assistants like Claude directly control Unity Editor through a local WebSocket server, exposing over 288 tools across 30+ categories for AI-assisted game development. You can describe what you want — create a player character, bake NavMesh, apply a shader, render the scene, or build for iOS — and the AI executes it inside your live Unity project. The plugin supports Unity 2021.3 LTS and newer and integrates optional packages like Shader Graph, Memory Profiler, VFX Graph, and Amplify Shader Editor for extended capabilities.
Prerequisites
- Unity 2021.3 LTS or newer (tested on Unity 2022.3 LTS and Unity 6)
- Claude Desktop, Cursor, or another MCP-compatible AI client
- The companion unity-mcp-server package for the AI client side
- Optional Unity packages for extended features: com.unity.shadergraph, com.unity.memoryprofiler, com.unity.multiplayer.playmode
Install the Unity MCP Plugin via Package Manager
Open Unity, go to Window > Package Manager, click the + button, and choose 'Add package from git URL'. Paste the repository URL. Unity will download and install the plugin automatically.
https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.gitStart the MCP bridge server in Unity Editor
After installation, restart Unity Editor. The plugin auto-starts a local server on port 7890. Verify it is running by opening Window > MCP Dashboard and checking the server status, or visit the ping endpoint in a browser.
http://127.0.0.1:7890/api/pingInstall the companion MCP server for your AI client
The AI client needs the unity-mcp-server package to communicate with the Unity bridge. Clone and set up the companion server from the AnkleBreaker-Studio organization on GitHub.
git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git
cd unity-mcp-server
npm install
npm run buildConfigure your AI client to connect to the Unity MCP server
Add the unity-mcp-server to your Claude Desktop config file. The server connects to the local Unity bridge running on port 7890.
{
"mcpServers": {
"unity": {
"command": "node",
"args": ["/absolute/path/to/unity-mcp-server/dist/index.js"]
}
}
}Configure optional features in the MCP Dashboard
Open Window > MCP Dashboard > Settings in Unity Editor to toggle category-specific tools on or off (physics, terrain, shader graph, profiling, etc.) and adjust the port if needed. Settings persist across editor sessions.
Verify the full pipeline with a test command
In Claude, ask it to ping Unity and create a simple GameObject. A successful response with the GameObject appearing in your Unity Hierarchy confirms the end-to-end connection is working.
Unity MCP Plugin Examples
Client configuration
MCP configuration to connect Claude Desktop to the Unity Editor bridge via the companion unity-mcp-server.
{
"mcpServers": {
"unity": {
"command": "node",
"args": ["/absolute/path/to/unity-mcp-server/dist/index.js"]
}
}
}Prompts to try
These prompts demonstrate the breadth of Unity Editor control available through the MCP plugin.
- "Create a new GameObject called 'Player' at position (0, 1, 0) and add a Rigidbody and CapsuleCollider component."
- "Open the MainScene, take a screenshot of the current camera view, and show it to me."
- "Bake the NavMesh for the current scene using the default agent settings."
- "Create a new Shader Graph for a holographic effect and open it in the editor."
- "Build the project for Android with development build enabled and log the output."
- "Profile the current scene for 5 seconds and report the top 10 CPU-heavy methods."
- "Add a terrain to the scene, raise a mountain in the center, and paint it with a rock texture."Troubleshooting Unity MCP Plugin
Ping to 127.0.0.1:7890 fails or the server does not start
Check the Unity Editor console for '[MCP Bridge] Server started on port 7890' messages. If missing, ensure the plugin installed correctly by looking for it in the Package Manager list. Try restarting Unity Editor. If port 7890 is already in use, change it in Window > MCP Dashboard > Settings.
Optional tools like Shader Graph or Memory Profiler are missing
These capabilities require their corresponding Unity packages to be installed. Install com.unity.shadergraph for Shader Graph tools, com.unity.memoryprofiler for memory snapshots, and so on via Window > Package Manager. The MCP Dashboard will auto-enable the category once the package is detected.
Attribution requirement in built products
The AnkleBreaker Open License v1.0 requires 'Made with AnkleBreaker MCP' attribution in products built using this plugin. Add this credit to your game's splash screen, credits, or about page. The license also prohibits resale or sublicensing of the plugin itself.
Frequently Asked Questions about Unity MCP Plugin
What is Unity MCP Plugin?
Unity MCP Plugin is a Model Context Protocol (MCP) server that unity mcp plugin (upm) — editor bridge for ai-assisted game development. enables claude, cursor & mcp-compatible ai to control unity editor with 268 tools: scenes, gameobjects, components, builds, profiling, shader graph, amplify shader editor, terra It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Unity MCP Plugin?
Follow the installation instructions on the Unity MCP Plugin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Unity MCP Plugin?
Unity MCP Plugin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Unity MCP Plugin free to use?
Yes, Unity MCP Plugin is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Unity MCP Plugin Alternatives — Similar Developer Tools Servers
Looking for alternatives to Unity MCP Plugin? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Unity MCP Plugin in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Unity MCP Plugin?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.