IvanMurzak/Unity-MCP

  
  
  
  
  
  
  
  
  
  
  
中文 | 日本語 | Español
Unity MCP is an AI-powered game development assistant **for Editor & Runtime**. Connect **Claude**, **Cursor**, & **Windsurf** to Unity via MCP. Automate workflows, generate code, and **enable AI within your games**.
Unlike other tools, this plugin works **inside your compiled game**, allowing for real-time AI debugging and player-AI interaction.
> **💬 Join our Discord Server** - Ask questions, showcase your work, and connect with other developers!
- ✔️ **AI agents** - Use the best agents from **Anthropic**, **OpenAI**, **Microsoft**, or any other provider with no vendor lock-in
- ✔️ **Tools** - A wide range of default MCP Tools for operating in Unity Editor
- ✔️ **Skills** - Generate skills for AI based on operating system, Unity version, plugins in the project
- ✔️ **Code and Tests** - Develop game mechanics and test them with AI agents
- ✔️ **Runtime (in-game)** - Use LLMs directly inside your compiled game for dynamic NPC behavior or debugging
- ✔️ **Debug support** - Let AI debug and fix the problems in a project
- ✔️ **Natural conversation** - Chat with AI like you would with a human
- ✔️ **Flexible deployment** - Works locally (stdio) and remotely (http) via configuration
- ✔️ **Extensible** - Create custom Tools in your project code
https://github.com/user-attachments/assets/228baf4d-4f00-4dce-939d-fb985ebdd8dd
OR use cli
Quick Start
Get up and running in three steps:
1. **Install plugin** — download the .unitypackage installer or run openupm add com.ivanmurzak.unity.mcp
> **Alternative:** npx unity-mcp-cli install-plugin ./MyUnityProject — see CLI documentation
2. **Pick an AI agent** — Claude Code, Claude Desktop, GitHub Copilot, Cursor, or any other
3. **Setup AI agent** — open Window/AI Game Developer in Unity and click **Auto-generate skills** (recommended) or **Configure MCP**
> **Alternative:** npx unity-mcp-cli setup-skills claude-code ./MyUnityProject — see CLI documentation
That's it. Ask your AI *"Create 3 cubes in a circle with radius 2"* and watch it happen. ✨
---
Skills and Tools Reference
The plugin ships with 70+ built-in tools across four categories. Each tool brings AI skill. All tools are available immediately after installation — no extra configuration required. See docs/default-mcp-tools.md for the full reference with detailed descriptions.
> 🧰 Browse the full MCP tools registry online: ai-game.dev/docs/tools
Project & Assets
- assets-copy - Copy the asset at path and stores it at newPath
- assets-create-folder - Creates a new folder in the specified parent folder
- assets-delete - Delete the assets at paths from the project
- assets-find - Search the asset database using the search filter string
- assets-find-built-in - Search the built-in assets of the Unity Editor
- assets-get-data - Get asset data from the asset file including all serializable fields and properties
- assets-material-create - Create new material asset with default parameters
- assets-modify - Modify asset file in the project
- assets-move - Move the assets at paths in the project (also used for rename)
- assets-prefab-close - Close currently opened prefab
- assets-prefab-create - Create a prefab from a GameObject in the current active scene
- assets-prefab-instantiate - Instantiates prefab in the current active scene
- assets-prefab-open - Open prefab edit mode for a specific GameObject
- assets-prefab-save - Save a prefab in prefab editing mode
- assets-refresh - Refreshes the AssetDatabase
- assets-shader-get-data - Get detailed data about a shader asset (properties, subshaders, passes)
- assets-shader-list-all - List all available shaders in the project assets and packages
- package-add - Install a package from the Unity Package Manager registry, Git URL, or local path
- package-list - List all packages installed in the Unity project (UPM packages)
- package-remove - Remove (uninstall) a package from the Unity project
- package-search - Search for packages in both Unity Package Manager registry and installed packages
Scene & Hierarchy
- gameobject-component-add - Add Component to GameObject
- gameobject-component-destroy - Destroy one or many components from target GameObject
- gameobject-component-get - Get detailed information about a specific Component on a GameObject
- gameobject-component-list-all - List C# class names extended from UnityEngine.Component