Unity MCP Server
MCP-сервер для Unity: управление сценой, объектами, компонентами, сборками и профилировкой из агента
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Управляет редактором Unity и меняет ваш проект
- Запускает сборки и может ставить редакторы через Unity Hub
Установка
Ручная установка
git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git
cd unity-mcp-server
npm installУстановка сервера из исходников. Компаньон-плагин ставится в Unity отдельно через Package Manager.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер соединяет агента с редактором Unity через компаньон-плагин, который ставится как UPM-пакет по git-ссылке. Агент работает со сценой и иерархией, создает и меняет GameObject и компоненты, управляет светом, окружением, скайбоксом и запеканием, ведет проект и его пакеты, настраивает сборки и запускает их, снимает профилировку и скриншоты сцены. Через Unity Hub можно смотреть и ставить редакторы и модули. Сервер сам находит запущенные экземпляры Unity, при нескольких предлагает выбрать нужный, а часть инструментов включается только при наличии соответствующих пакетов в проекте.
Для кого. Для разработчиков игр на Unity, которые хотят управлять редактором и сборками через агента.
Подходит, если
- Нужно собрать сцену, объекты и компоненты по описанию
- Нужно настроить и запустить сборку проекта
- Нужно снять профилировку или скриншот сцены из агента
Не подходит, если
- Нет установленного Unity 2021.3 LTS или новее
- Нельзя поставить компаньон-плагин через Unity Package Manager
Пример запроса к агенту
Создай красный куб в позиции 0, 2, 0, добавь ему Rigidbody и покажи иерархию сценыОграничения
Нужны Node.js 18 или новее, Unity 2021.3 LTS или новее и компаньон-плагин unity-mcp-plugin, поставленный через UPM. Пути и порты моста задаются переменными окружения. Лицензия AnkleBreaker Open License требует указывать авторство и запрещает перепродажу инструмента, для личного и учебного использования атрибуция не обязательна. Часть инструментов работает только при установленных пакетах вроде Amplify Shader Editor.
Как отключить. Уберите запись сервера из конфигурации MCP-клиента и удалите компаньон-плагин из Unity через Package Manager.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| UNITY_HUB_PATH | Путь к исполняемому файлу Unity Hub. |
| UNITY_BRIDGE_PORT | Порт моста редактора, по умолчанию 7890. |
Проверка безопасности
- Управляет редактором Unity и меняет ваш проект
- Запускает сборки и может ставить редакторы через Unity Hub
Коротко о README
README описывает установку компаньон-плагина через UPM, установку сервера из исходников с npm install и настройку клиента через node src/index.js. Перечислены группы инструментов: сцена, объекты, компоненты, свет, проект, сборки, профилировка, ввод и работа с Unity Hub. Указаны переменные окружения для путей и портов, требования к версиям и раздел с опциональными пакетами. Отмечено, что сервер и плагин бесплатны и открыты под AnkleBreaker Open License.
Частые вопросы
Что нужно поставить в самом Unity?
Компаньон-плагин unity-mcp-plugin через Unity Package Manager по git-ссылке. Без него инструменты редактора не работают.
Есть ли ограничения лицензии?
Да, лицензия требует указывать авторство и запрещает перепродажу инструмента. Личное и учебное использование от атрибуции освобождено.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything