================== /// MCP /// /// UNI /// ================== [server:online] [protocol:ready]
Unity-MCP
by IvanMurzak
Bridge between Large-Language-Model (LLM) clients (Claude, Cursor, custom) 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” (GameObject, Scene, Assets, Prefab, etc.) so an external client can query or manipulate the open Unity project.
303
29
SpecializedInstallation
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”.
Documentation
License: Apache License 2.0
Updated 7/30/2025