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

# 1. Install unity-mcp-cli
npm install -g unity-mcp-cli

# 2. Install "AI Game Developer" in Unity project
unity-mcp-cli install-plugin ./MyUnityProject

# 3. Sign in to ai-game.dev (opens your browser — OAuth device flow)
unity-mcp-cli login

# 4. Open Unity project (auto-connects and generates skills)
unity-mcp-cli open ./MyUnityProject

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

• 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

• 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
• gameobject-component-modify - Modify a specific Component on a GameObject
• gameobject-create - Create a new GameObject in opened Prefab or in a Scene
• gameobject-destroy - Destroy GameObject and all nested GameObjects recursively
• gameobject-duplicate - Duplicate GameObjects in opened Prefab or in a Scene
• gameobject-find - Finds specific GameObject by provided information
• gameobject-modify - Modify GameObjects and/or attached component's fields and properties
• gameobject-set-parent - Set parent GameObject to list of GameObjects
• object-get-data - Get data of the specified Unity Object
• object-modify - Modify the specified Unity Object
• scene-create - Create new scene in the project assets
• scene-get-data - Retrieves the list of root GameObjects in the specified scene
• scene-list-opened - Returns the list of currently opened scenes in Unity Editor
• scene-open - Open scene from the project asset file
• scene-save - Save opened scene to the asset file
• scene-set-active - Set the specified opened scene as the active scene