unity-mcp README

The project's README from github.com/CoplayDev/unity-mcp. As one markdown file: README.md.

MCP for Unity

English ↔ 简体中文    |    Discord ↔ Wiki

Proudly sponsored and maintained by Aura — the AI assistant for Unreal & Unity.

And don't miss Godot AI, the new open source project from the makers of MCP for Unity.

Create your Unity apps with LLMs. MCP for Unity bridges AI assistants — Claude, Codex, VS Code, local LLMs, and more — with your Unity Editor via Model Context Protocol. Give your LLM the tools to manage assets, control scenes, edit scripts, run tests, and automate your game dev workflows.

MCP for Unity building a scene


Recent Updates

Full history: Release Notes.


What it does

Control the Unity Editor in natural language from any MCP client — create scenes & GameObjects, edit C# scripts, manage assets, run tests, profile, and build. 47 focused MCP tool entrypoints, any client, free & MIT.

Browse the full tool catalog →


Quickstart

Requirements: Unity 2021.3 LTS → 6.x · Python 3.10+ (via uv). Works with any MCP client — Claude Desktop & Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, and more.

  1. Install — Unity → Package Manager → Add from git URL: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main  (pin #v10.0.0 for this release, or openupm add com.coplaydev.unity-mcp)
  2. Configure — Window → MCP for Unity → Configure All Detected Clients.
  3. Prompt — "Create a cube at the origin and add a Rigidbody." The cube appears in seconds.

Community

Contributing

See CONTRIBUTING.md. Branch off beta, not main. The full dev setup, testing, and release process live in the Contributing docs.

Advanced

Star History

Star History Chart

Citation

If MCP for Unity helped your research, please cite it.

@inproceedings{wu2025mcpunity,
  author    = {Wu, Shutong and Barnett, Justin P.},
  title     = {{MCP-Unity}: {Protocol-Driven} Framework for Interactive {3D} Authoring},
  year      = {2025},
  isbn      = {9798400721366},
  publisher = {Association for Computing Machinery},
  address   = {New York, NY, USA},
  url       = {https://doi.org/10.1145/3757376.3771417},
  doi       = {10.1145/3757376.3771417},
  series    = {SA Technical Communications '25}
}

Unity AI Tools by Aura

Aura offers 2 AI tools for Unity:

Disclaimer

This project is a free and open-source tool for the Unity Editor, and is not affiliated with Unity Technologies.


License: MIT — see LICENSE.

unity-mcp (CoplayDev/unity-mcp)

Searching Database…

Что это такое?Это MCP for Unity — open-source мост, который подключает ИИ-ассистентов вроде Claude или Cursor к вашему Unity Editor, чтобы LLM мог управлять ассетами, работать со сценами, редактировать скрипты и автоматизировать разработку игр.
Так это плагин внутри Unity или отдельное приложение?И то и другое — две половины одного моста: пакет, который устанавливается внутри Unity Editor, плюс MCP-сервер, открывающий 47 узкоспециализированных инструментов, которые может вызывать ваш ИИ-ассистент.
Как его запустить?Добавьте пакет по git URL в Package Manager внутри Unity (или выполните openupm add com.coplaydev.unity-mcp), затем откройте Window → MCP for Unity → Configure All Detected Clients.
Что должно быть установлено заранее?Unity 2021.3 LTS до Unity 6.x, а также Python 3.10+, который setup настраивает через uv.
Есть ли подводные камни при установке?При добавлении git URL закрепите тег релиза, например #v10.0.0, чтобы получить стабильную версию; вариант через openupm вместо этого ставит фиксированную версию пакета.
Какие ИИ-ассистенты можно к нему подключить?Подойдёт любой MCP-клиент — Claude Desktop и Claude Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI и другие.
Он бесплатный или есть платная версия?Полностью бесплатен по лицензии MIT. В README также отмечено, что проект никак не связан с Unity Technologies.
Что ИИ реально может делать внутри редактора?Создавать сцены и GameObjects, редактировать C#-скрипты, управлять ассетами, запускать тесты, профилировать и собирать сборку — всего 47 узкоспециализированных инструментов.
У меня одновременно открыто несколько проектов Unity — это поддерживается?Да, маршрутизация между несколькими экземплярами (multi-instance routing) — документированная расширенная возможность для работы с несколькими копиями Unity.
Может ли он проверять C#-скрипты, которые пишет ИИ?Да — валидация скриптов через Roslyn — документированная расширенная возможность, а группы инструментов позволяют ограничить доступ к таким областям, как vfx, animation, ui и testing.
Это то же самое, что платный ассистент Aura?Нет — MCP for Unity бесплатен и распространяется по лицензии MIT. Aura for Unity — отдельный платный ИИ-ассистент для Unity и Unreal от той же команды.
Creator
CoplayDev
Size
44.9 MB
Stars
15K
Age
1y
Commits · 90 Days