AnkleBreaker Unity MCP Plugin
Пакет Unity с локальным мостом в редакторе: агент через MCP управляет сценами, префабами, сборками и тестами
- 257 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент получает инструменты выполнения кода и правки сцен, скриптов и ассетов проекта с правами процесса редактора
- Через те же маршруты запускаются сборки проекта и тесты, они меняют файлы на диске
- Несколько агентов в одном редакторе могут вносить конфликтующие правки: очередь только упорядочивает запросы
Установка
- Работает в
Ручная установка
git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git
cd unity-mcp-server
npm installКомпаньон-сервер на Node.js, без него агент не достучится до моста. Подробности настройки клиента в репозитории сервера.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает инструменты выполнения кода и правки сцен, скриптов и ассетов проекта с правами процесса редактора
- Через те же маршруты запускаются сборки проекта и тесты, они меняют файлы на диске
- Несколько агентов в одном редакторе могут вносить конфликтующие правки: очередь только упорядочивает запросы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AnkleBreaker Unity MCP Plugin — это сторона Unity для MCP-сервера AnkleBreaker. Пакет UPM запускает в редакторе локальный HTTP-мост, а сервер на Node.js передает ему команды агента. Мост регистрирует 338 маршрутов редактора: сцены и объекты, компоненты, префабы, материалы, анимацию, ландшафт, частицы, звук, интерфейс, освещение, навигацию, сборки, профилирование и скрипты. Мост рассчитан на несколько агентов и несколько проектов сразу. У каждого редактора свой слушатель, очередь и идентичность, а запросы разных агентов выстраиваются в очередь на агента и обслуживаются по кругу. Для многопользовательской разработки есть управление сценариями и игроками Multiplayer Play Mode и поиск клонов ParrelSync. В редакторе пакет добавляет панель состояния MCP в главную панель инструментов и окно Dashboard с очередью, карточками агентов, HTTP-активностью и журналом действий. Поддерживаемые изменения записываются как именованные группы отмены. Для ProBuilder, UMA, Amplify Shader Editor, Shader Graph, VFX Graph, Input System и Memory Profiler предусмотрены необязательные интеграции: их инструменты агент находит вызовом `unity_list_advanced_tools`.
Для кого. Для разработчиков игр на Unity, которые хотят отдать агенту работу в редакторе и при необходимости запускать в одном проекте несколько агентов.
Подходит, если
- Агент должен собирать сцену в открытом редакторе: расставлять объекты, настраивать материалы и освещение, править компоненты
- В проекте работают несколько агентов, и их запросы к одному редактору нужно ставить в очередь без конфликтов
- Нужно запускать тесты EditMode и PlayMode и получать результаты постранично, сохраняя номер задания
- Вы отлаживаете сетевую игру и хотите управлять сценариями Multiplayer Play Mode и клонами ParrelSync из агента
- Хочется видеть, какие действия и запросы выполнил каждый агент, и отменять поддерживаемые изменения
Не подходит, если
- Вы работаете в Godot, Unreal или другом движке: пакет работает только в редакторе Unity 2021.3.18f1 и новее
- Нужна одна установка без Node.js: для работы с агентом требуется отдельный MCP-сервер, один пакет в Unity его не заменяет
- Редактор открыт на общей или недоверенной машине: инструменты выполнения кода получают права процесса редактора
- Нужно гарантированно откатить любое изменение: отмена работает только для команд, которые регистрируют операции отмены Unity
Пример запроса к агенту
Покажи запущенные редакторы Unity, выбери мой прототип и проверь сцену и ошибки компиляции, прежде чем что-то менятьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Пакет работает только вместе с сервером AnkleBreaker на Node.js и клиентом MCP. Нужен Unity 2021.3.18f1 или новее, а пакеты uGUI и Unity Test Framework подтягиваются как зависимости. Версии пакета и сервера выходят независимо, совпадать им не нужно. Установка с адреса `#main` дает свежие изменения, а опубликованные пакеты npm и метки версий могут от них отставать.
Мост слушает только локальный адрес и по умолчанию использует порт 7890. После перезапуска редактора порт может смениться, поэтому проект и порт нужно узнавать заново. Тяжелые операции Unity занимают главный поток редактора, и очередь не делает их неблокирующими. Отмена охватывает только часть команд. Таймаут не прерывает уже начатую работу. Лицензия нестандартная, перед коммерческим использованием прочитайте файл LICENSE. Работа UMA 2 в рантайме не проверена.
Как отключить. Откройте Window, Package Manager в Unity и удалите пакет AnkleBreaker Unity MCP Plugin, затем уберите запись unity из конфигурации MCP-клиента. Состояние моста и очередь можно посмотреть в окне Dashboard до удаления.
Частые вопросы
Как установить Unity MCP Plugin от AnkleBreaker?
В Unity откройте Window, Package Manager, Add package from git URL и вставьте `https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git#main`. Затем откройте Window, AB Unity MCP, Dashboard, проверьте состояние моста и поставьте отдельный Node-сервер.
Чем плагин отличается от сервера AnkleBreaker?
Плагин живет внутри Unity и исполняет команды в редакторе: очередь, история, интеграции. Сервер на Node.js общается с вашим MCP-клиентом и направляет каждый запрос в нужный редактор. Для работы нужны оба.
Как работают несколько агентов в одном редакторе?
У каждого агента своя очередь, и запросы обслуживаются по кругу, а чтения сгруппированы. За один проход редактор выполняет одну запись или до пяти заранее классифицированных чтений. Очередь упорядочивает запросы, но конфликтующие правки разных агентов не разрешает.
Какой порт использует мост и что делать при нескольких проектах?
По умолчанию 7890, а несколько редакторов занимают разные порты. Вызовите `unity_list_instances`, выберите проект и передавайте найденный порт в параллельных запросах, не полагаясь на значение после перезапуска.
Что можно отменить после правок агента?
Поддерживаемые синхронные записи получают именованные группы отмены, историю смотрите через `unity_undo_history`. Команды, которые не регистрируют отмену Unity, и изменения в файловой системе этим способом не откатить.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыУправление редактором Unity из агента через MCP: сцены и объекты, C#-скрипты, ассеты, тесты, профилирование и сборка
Пакет Unity: редактор сам отдает MCP по HTTP, а агент и командная строка управляют сценами, ассетами и сборкой
MCP-сервер, который связывает AI-агента с редактором Unity: управление сценой, объектами, пакетами и ресурсами проекта
MCP-сервер для Unity: управление сценой, объектами, компонентами, сборками и профилировкой из агента
Плагин Unity с MCP-сервером, скиллами и CLI: агент управляет сценами, ассетами, скриптами и тестами в редакторе Unity
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AnkleBreaker Unity MCP Plugin (эта карточка) | нет | не нужна | 257 | |
| Unity MCP Server | нет | не нужна | 542 | сервер на Node.js для MCP-клиента, пакет в Unity ставится отдельно |
| MCP for Unity | нет | не нужна | 15 943 | MCP для Unity с другим мостом и набором инструментов |
| AI Game Developer (Unity MCP) | нет | не нужна | 4 631 | плагин Unity с собственным MCP-сервером, скиллами и CLI |
Коротко о README
Документ описывает пакет как редакторскую часть рабочего процесса для нескольких проектов, агентов и многопользовательской итерации. В нем есть демонстрационные записи сборки сцен, схема работы моста, замеры скорости и описание панели мониторинга. Измеренные улучшения привязаны к конкретным нагрузкам, и автор оговаривает это сам.