Repolode
Submit
IvanMurzak

IvanMurzak/Unity-MCP

Unity Editor and runtime plugin and MCP server that lets AI agents like Claude, Cursor and Copilot operate Unity projects and run LLMs inside games.

View on GitHubWebsite
Stars
4,497
Forks
399
Open issues
59
Last commit
17 hours ago

What is it?

Unity-MCP is a plugin and MCP server that connects AI agents such as Claude Code, Claude Desktop, Cursor, GitHub Copilot and Gemini to the Unity Editor. Once installed, an agent can inspect the scene hierarchy, create and modify GameObjects and components, manage assets, prefabs and scenes, read the console, control play mode, take screenshots and run Unity tests.

Beyond editor automation, the project includes a runtime package that lets a compiled game expose its own methods as MCP tools, so LLMs can drive in-game behavior such as NPC decisions or a chess bot. Developers can add custom tools by annotating a C# method with an attribute. The plugin also generates AI skill files based on the project's Unity version and installed packages.

Setup is available through an installer package, OpenUPM, or the unity-mcp-cli command-line tool. The server can run locally over stdio or remotely over streamable HTTP, including in Docker.

Key features

  • 01Lets AI agents read and modify scenes, GameObjects, components and assets in the Unity Editor.
  • 02Provides 70+ built-in MCP tools covering assets, scenes, scripting, console and profiling.
  • 03Compiles and runs C# code at runtime through Roslyn.
  • 04Runs LLM-driven logic inside compiled games via a runtime package.
  • 05Supports custom tools defined by annotating C# methods.
  • 06Works over local stdio or remote streamable HTTP, with Docker images available.

Use cases

  • Having an AI agent build scene layouts, prefabs and materials from natural-language prompts.
  • Letting an AI agent run Unity tests and inspect console errors while debugging a project.
  • Adding an LLM-controlled NPC or game bot inside a shipped Unity game.
  • Automating editor tasks in a team project through the CLI and Docker-hosted server.

Quick start

  1. 1

    Install the Node CLI globally

    npm install -g unity-mcp-cli
  2. 2

    Install the plugin into your Unity project

    unity-mcp-cli install-plugin ./MyUnityProject
  3. 3

    Sign in to ai-game.dev in your browser

    unity-mcp-cli login
  4. 4

    Open the Unity project to auto-connect and generate skills

    unity-mcp-cli open ./MyUnityProject

Things to know

  • Requires a Unity project, since it is a plugin for the Unity Editor and runtime.
  • The quick CLI path requires signing in to the ai-game.dev service via OAuth.

Topics

#unity#mcp#ai-agent#game-development#llm#claude-code#csharp#model-context-protocol#ai#ai-integration

FAQ

What is Unity-MCP?
Unity Editor and runtime plugin and MCP server that lets AI agents like Claude, Cursor and Copilot operate Unity projects and run LLMs inside games. Unity-MCP is a plugin and MCP server that connects AI agents such as Claude Code, Claude Desktop, Cursor, GitHub Copilot and Gemini to the Unity Editor. Once installed, an agent can inspect the scene hierarchy, create and modify GameObjects and components, manage assets, prefabs and scenes, read the console, control play mode, take screenshots and run Unity tests.
Is Unity-MCP free to use? What license does it have?
Unity-MCP is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is Unity-MCP still maintained?
Actively maintained. The last commit to Unity-MCP was on Oct 19, 2026.
What can I use Unity-MCP for?
Having an AI agent build scene layouts, prefabs and materials from natural-language prompts. Letting an AI agent run Unity tests and inspect console errors while debugging a project. Adding an LLM-controlled NPC or game bot inside a shipped Unity game. Automating editor tasks in a team project through the CLI and Docker-hosted server.
How do I install Unity-MCP?
Install the Node CLI globally: npm install -g unity-mcp-cli Install the plugin into your Unity project: unity-mcp-cli install-plugin ./MyUnityProject Sign in to ai-game.dev in your browser: unity-mcp-cli login Open the Unity project to auto-connect and generate skills: unity-mcp-cli open ./MyUnityProject
Where can I get Unity-MCP?
The source code and installation instructions are on GitHub: https://github.com/IvanMurzak/Unity-MCP

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects