Unity-MCP

Author: Ivan Murzak
Description: Bridge between Large-Language-Model (LLM) clients (Claude, Augment Code, etc) and the Unity Editor. Ships as a Unity-package that spins up an MCP server inside the editor and exposes a catalogue of AI-driven “tools” so an external client can query or manipulate the open Unity project.
Stars: 303
Forks: 29
License: Apache License 2.0
Category: Specialized

Overview

Transform Unity Development with Augment Code + Unity-MCP

Unity-MCP turns Augment Code into your AI-powered Unity development partner. Instead of just generating code, Augment can now directly manipulate your Unity projects - creating GameObjects, modifying components, managing scenes, and automating complex workflows through natural language commands.

Live Unity Editor Integration

Unlike traditional AI coding assistants that only generate code, Unity-MCP creates a live bridge between Augment Code and your Unity Editor. When you ask Augment to "create a player GameObject with a Rigidbody and BoxCollider," it doesn't just write the code - it actually creates the GameObject in your scene, adds the components, and configures them. This real-time integration means Augment can see your current scene hierarchy, inspect component values, and make intelligent decisions based on your project's actual state.

Setting up this powerful combination is straightforward: install the Unity-MCP package in your project, configure the MCP server connection in Augment's settings, and start commanding your Unity project through natural language. Augment can now perform tasks like "duplicate all enemies in the scene and place them in a formation," "create a new scene with proper lighting setup," or "find all GameObjects using the old material and update them to the new PBR material."

Supercharge Your Unity Workflows

This integration eliminates the tedious back-and-forth between writing code and manually setting up Unity scenes. Ask Augment to "create a complete UI system with health bar, inventory panel, and pause menu" - and watch as it generates the prefabs, configures the components, sets up the proper parenting relationships, and even runs your test suite to ensure everything works. The extensive tool catalog covers every aspect of Unity development: GameObject manipulation, component management, asset handling, scene operations, material assignments, script creation, and even running Unity tests.

For Unity developers tired of repetitive editor tasks, Unity-MCP + Augment Code represents a paradigm shift toward AI-driven development workflows where your ideas translate directly into working Unity scenes through conversation.

Installation

Unity-MCP is delivered as a Unity package (client-side) and a small .NET server.

Prerequisites

  1. Unity 2021.3 LTS or newer.
  2. .NET 8.0 SDK (for building/running the standalone server).
  3. Optional: An OpenAI/Anthropic/Ollama key if you want to forward calls to those back-ends.

A. Install the Unity package

  1. Open your Unity project.

  2. Window ▶ Package Manager ▶ “+” ▶ Add package from Git URL…

  3. Paste

    https://github.com/IvanMurzak/Unity-MCP.git?path=Packages/com.ivanmurzak.mcp

  4. Click Add. Unity will clone the repo and register the package.

B. Build / run the MCP Server

# clone the repository (or reuse the copy Unity already downloaded)
$ git clone https://github.com/IvanMurzak/Unity-MCP.git
$ cd Unity-MCP/Server

# restore & build
$ dotnet restore
$ dotnet build -c Release

# first-time configuration (copies the example config)
$ cp appsettings.sample.json appsettings.json
# edit appsettings.json and insert your provider keys
#   "OpenAI": { "ApiKey": "sk-..." }

# run the server
$ dotnet UnityMCP.Server.dll
# By default the server listens on http://localhost:5037

C. Connect from Unity

  1. In Unity ▶ Edit ▶ Project Settings ▶ MCP.
  2. Set “Server URL” to http://localhost:5037.
  3. Press Play – the editor and in-game scripts can now call MCP methods.

Updating

Run git pull inside the cloned repo and restart the server, or in Unity right-click the package ▶ “Resolve.”

Available Tools (60) Click to expand

License: Apache License 2.0
Updated: 7/30/2025