Unity MCP (CoplayDev): AI-ассистент прямо в Unity Editor

«Скажи AI создать куб с Rigidbody — и он появится в сцене за секунды.» Именно так работает Unity MCP.

Что это и для кого

MCP for Unity соединяет AI-ассистентов — Claude, Codex, VS Code, локальные LLM и другие — с Unity Editor через протокол Model Context Protocol. Проект разработан командой CoplayDev и распространяется свободно.

Инструмент доступен по лицензии MIT и не является официальным продуктом Unity Technologies.

Для кого подойдёт:

  • Unity-разработчики, уже использующие Claude Code, Cursor или GitHub Copilot
  • Инди-разработчики, желающие автоматизировать рутинные задачи в редакторе
  • Исследователи и студенты, изучающие AI-driven разработку игр
  • Команды, которые хотят подключить собственный LLM к пайплайну разработки
ℹ Академическое признание
Проект был процитирован в академической конференции ACM: статья «MCP-Unity: Protocol-Driven Framework for Interactive 3D Authoring» была опубликована в SA Technical Communications 2025.

Архитектура: как это работает

MCP-клиент никогда не общается с Unity напрямую — Python-сервер в середине занимается маршрутизацией, изоляцией сессий и взаимодействием с C# плагином редактора.


graph LR
    A["MCP-клиент\n(Claude / Cursor / Copilot)"] -->|"MCP Protocol"| B["Python MCP Server\n(uvx / localhost:8080)"]
    B -->|"HTTP / stdio"| C["Unity Bridge\n(C# плагин в Editor)"]
    C -->|"Unity Editor API"| D["Сцена / Ассеты / Скрипты"]
    D -->|"Structured payload"| C
    C --> B
    B --> A

Команды принимаются в главном потоке Unity, выполняются через Unity Editor API и возвращают структурированные данные.


Ключевые возможности

47 инструментов в 10 группах

47 инструментов в 10 группах открывают поверхность редактирования Unity для вашего MCP-клиента.

Более 40 инструментов Unity Editor доступны через MCP — manage_scene, manage_script, manage_gameobject, manage_material, manage_physics, run_tests и другие. Более 25 read-only ресурсов для интроспекции состояния — editor_state, gameobject_components, project_info, unity_instances и т.д.

Поддерживаемые группы инструментов

Активируйте инструменты для анимации, VFX, UI, тестирования или ProBuilder только тогда, когда они нужны. Меньший промпт, более точная маршрутизация, меньше расходов на токены.

Мультиклиентная поддержка

Автоконфигурация для популярных MCP-клиентов: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Qwen, Gemini CLI, Copilot CLI, OpenClaw.

Мульти-инстанс маршрутизация

Поддержка нескольких инстансов — управление несколькими Unity Editor из одной сессии через set_active_instance.

Два транспорта

Два транспорта: HTTP (для мультиагентных и удалённых сценариев, по умолчанию) и stdio (для одиночного клиента, например Claude Desktop).

📝 Пример промпта
«Create a cube at the origin and add a Rigidbody.» — куб появляется в сцене за секунды без единой строки ручного кода.

Установка за 3 шага

# Шаг 1: Установка Unity-пакета через Package Manager
# Window → Package Manager → + → Add package from git URL
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

# Или через OpenUPM:
openupm add com.coplaydev.unity-mcp

После установки: Window → MCP for Unity → Configure All Detected Clients.

Требования: Unity 2021.3 LTS → 6.x, Python 3.10+ (через uv).

⚠ Важно
Для работы необходим установленный Python и менеджер пакетов uv (uvx). Если Python не обнаружен — в интерфейсе появится кнопка «Open Install Instructions».

Тарифы и цены

Проект MCP for Unity с открытым исходным кодом полностью бесплатен по лицензии MIT. Однако вам может потребоваться оплатить AI-модель, которую вы используете (например, через API-ключ), или премиум-клиент.

КомпонентСтоимость
Unity MCP пакетБесплатно (MIT)
Python MCP серверБесплатно
Claude Code / Cursor / CopilotПо тарифам провайдера
Локальные LLM (Ollama и др.)Бесплатно

Плюсы и минусы

✅ Плюсы❌ Минусы
Полностью бесплатен (MIT)Требует Python + uv для настройки
47 инструментов «из коробки»Начальная настройка может быть сложной
Поддержка 10+ MCP-клиентовНет поддержки старых версий Unity (< 2021.3)
Мульти-инстанс поддержкаRuntime MCP (в Play Mode) пока в роадмапе
Активное сообщество и DiscordЗависимость от сторонних LLM-провайдеров
Расширяемость (custom tools)Документация может отставать от beta-веток
Академическое признание (ACM)Не аффилирован с Unity Technologies

Сравнение с альтернативами

ПараметрCoplayDev Unity MCPUnity AI Beta (Official)IvanMurzak/Unity-MCP
ЛицензияMIT (бесплатно)$10/мес (Personal)MIT (бесплатно)
Инструментов47Нет данных70+
Клиенты10+ (Claude, Cursor, VS Code…)Claude, Copilot через GatewayClaude, Cursor, Gemini…
ТранспортHTTP + stdiorelay_win.exe / stdioHTTP
Unity версии2021.3 LTS → 6.xUnity 6.0+ толькоНет данных
Runtime (Play Mode)В роадмапеНет✅ Да
Стабильность процессов✅ HTTP в Editor⚠️ Проблемы с zombie-процессами
Академические публикации✅ ACM SA'25

CoplayDev-версия использует более простую 2-слойную архитектуру: HTTP-сервер запускается прямо внутри редактора, и если Editor падает, HTTP-сервер останавливается вместе с ним. Поскольку граница управления процессами совпадает с Editor, очистка не требуется.

Официальный Unity MCP требует строго Unity 6.0 или новее.

IvanMurzak/Unity-MCP поставляется с 70+ встроенными инструментами в четырёх категориях, а также поддерживает Runtime-режим внутри скомпилированной игры.

💡 Совет по выбору
Если вы уже работаете в VS Code, Cursor или Claude Code — CoplayDev Unity MCP это ваш выбор. Если нужен официальный продукт с поддержкой Unity — смотрите Unity AI Beta, но только для Unity 6+.

Роадмап

В планах: исследование Runtime MCP Operation и добавление GenAI-плагинов для 2D и 3D ассетов.

Основные цели проекта: обеспечить надёжный и гибкий мост между Unity Editor и внешними MCP-клиентами. Приоритеты: упростить онбординг, улучшить скорость и снизить задержку, расширить интеграции.


Вердикт

Unity MCP от CoplayDev — лучший выбор для разработчиков, которые хотят подключить любимый AI-ассистент (Claude, Cursor, Copilot) к Unity Editor без дополнительных затрат. Инструмент активно развивается, имеет академическое признание и сильное сообщество.

Если вы работаете в VS Code, Cursor или Claude Code — CoplayDev MCP for Unity это лучший AI-инструмент для Unity-разработки именно для вас.

Кому особенно подойдёт:

  • Разработчикам с существующей подпиской на Claude/Cursor/Copilot
  • Open-source энтузиастам, желающим расширить инструментарий
  • Командам, которым нужна мультиклиентная и мульти-инстанс поддержка

Рейтинг: 8.5 / 10

КритерийОценка
Функциональность9/10
Простота настройки7/10
Гибкость интеграций10/10
Документация8/10
Цена/качество10/10