gitwtfhub

wtf is unity-mcp?

coplaydev/unity-mcp — explained in plain English

Analysis updated 2026-05-18

12,746C#Audience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

MCP for Unity lets AI assistants like Claude control the Unity game engine directly, creating scenes, editing scripts, and managing assets through natural language requests.

Mindmap

mindmap
  root((unity-mcp))
    What it does
      AI controls Unity Editor
      Natural language commands
      47 MCP tools
    Tech stack
      C#
      Unity Editor
      Python
      MCP protocol
    Use cases
      Scene and object creation
      Script editing
      Test and build automation
    Audience
      Game developers
      Unity teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Ask an AI assistant to create GameObjects, scenes, and components in Unity by describing them in plain English.

REASON 2

Have an AI assistant write, edit, and validate C# scripts directly inside a Unity project.

REASON 3

Automate repetitive Unity tasks like running tests, profiling, or building the project through chat commands.

What's in the stack?

C#UnityPythonModel Context Protocol

How it stacks up

coplaydev/unity-mcpunity-technologies/unitycsreferencesubtitleedit/subtitleedit
Stars12,74612,83112,853
LanguageC#C#C#
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Unity 2021.3 LTS or newer and Python 3.10+ via uv, install through Unity's Package Manager.

MIT license, free to use including commercial use as long as the copyright notice is kept.

Wtf does this do

MCP for Unity connects AI chat assistants like Claude to the Unity game engine's editor, letting you control Unity using plain English instead of clicking through menus by hand. It works through the Model Context Protocol, an open standard for letting AI tools talk to other software, so it can be used with Claude Desktop, Claude Code, Cursor, VS Code, and several other AI clients, not just one specific app. Once connected, you can ask your AI assistant to create scenes and objects in your game, write or edit C# scripts, manage game assets, run tests, profile performance, and build the project, all by describing what you want in natural language. For example, typing something like create a cube at the origin and add a Rigidbody actually creates that object inside the Unity Editor within seconds. The project exposes 47 separate tools that the AI assistant can call, covering these different areas of Unity development. Getting started involves installing the package into Unity through its Package Manager using a git URL, then running a one time configuration step that automatically sets up any supported AI client detected on your machine. From there, you simply type a request into your AI assistant's chat window. The project requires Unity version 2021.3 LTS or newer up through Unity 6, along with Python 3.10 or newer, installed through a tool called uv. MCP for Unity is free and open source under the MIT license, and it also supports more advanced setups such as running multiple Unity instances at once, grouping tools by category like animation or testing, and validating generated scripts before they are applied. The project is maintained with sponsorship from a company called Aura, which also sells a separate paid AI assistant for Unity and Unreal, though MCP for Unity itself remains free. It is not affiliated with or endorsed by Unity Technologies, the maker of the Unity engine.

Yoink these prompts

Prompt 1
Help me install MCP for Unity in my project and configure it to work with Claude Code.
Prompt 2
Create a cube at the origin with a Rigidbody component using MCP for Unity.
Prompt 3
Explain how MCP for Unity's tool groups work and how to enable just the animation and testing tools.
Prompt 4
Walk me through setting up MCP for Unity with multiple Unity instances running at once.

Frequently asked questions

wtf is unity-mcp?

MCP for Unity lets AI assistants like Claude control the Unity game engine directly, creating scenes, editing scripts, and managing assets through natural language requests.

What language is unity-mcp written in?

Mainly C#. The stack also includes C#, Unity, Python.

What license does unity-mcp use?

MIT license, free to use including commercial use as long as the copyright notice is kept.

How hard is unity-mcp to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is unity-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.