UnityMCP
Пакет Unity: редактор сам отдает MCP по HTTP, а агент и командная строка управляют сценами, ассетами и сборкой
- 338 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент запуска C# выполняет код внутри Unity Editor
- Инструменты создания меняют сцены, ассеты и префабы вашего проекта
- Файлы дескриптора и токена открывают любому прочитавшему их исполнение кода в редакторе
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/isuzu-shiranui/UnityMCP/main/install.sh | shСтавит isuzu-unity-cli на macOS и Linux. Для Windows есть install.ps1, а с .NET 10 SDK работает dotnet tool install -g IsuzuUnityCli.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент запуска C# выполняет код внутри Unity Editor
- Инструменты создания меняют сцены, ассеты и префабы вашего проекта
- Файлы дескриптора и токена открывают любому прочитавшему их исполнение кода в редакторе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UnityMCP — пакет для Unity Editor, который превращает сам редактор в MCP-сервер. Клиент подключается напрямую к адресу http://127.0.0.1:порт/mcp. Подключение проверено с Claude Code, Cursor, Codex, Gemini CLI, VS Code и Claude Desktop. Инструменты разбиты на группы. Диагностика читает консоль, Editor.log, статус компиляции и тесты, а еще иерархию сцены и ассеты. Группа создания правит объекты, компоненты, сцены и префабы, и каждый вызов сворачивается в один шаг отмены. Отдельно есть рендеринг, Timeline и Recorder, сборки, запуск фрагмента C# и имитация ввода в редакторе. Та же работа доступна из терминала через isuzu-unity-cli. Исполняемый файл не требует Node и .NET. Команда isuzu-unity-cli verify пересобирает проект, собирает ошибки и читает консоль за один вызов. Свой инструмент добавляют статическим методом C# с атрибутом McpTool или JSON-файлом.
Для кого. Для разработчиков игр на Unity, которые хотят, чтобы агент сам собирал сцены, правил ассеты и проверял сборку.
Подходит, если
- Агент должен создать объекты и компоненты в сцене и сохранить результат одним шагом отмены
- После правки скрипта нужно пересобрать проект и получить список ошибок компиляции
- В CI или скрипте надо вызвать инструмент редактора из командной строки
- Нужно запустить тесты Unity и прочитать их результаты через агента
Не подходит, если
- Версия Unity ниже 2022.3: она не поддерживается
- Нужен доступ к уже собранной игре: инструменты работают только в редакторе, в сборку игрока ничего не попадает
- Вы работаете вне Unity: пакет делается только для этого редактора
- Нельзя допускать выполнения кода агентом в редакторе: есть инструмент запуска фрагмента C#
Пример запроса к агенту
Пересобери проект, покажи ошибки консоли и после этого запусти тесты EditModeMCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
Нужен Unity Editor 2022.3 или новее (тесты автора идут на Unity 6000.0.35f1) и Git 2.14.0 или новее для установки по адресу репозитория. Зависимость com.unity.nuget.newtonsoft-json 3.2.1 подтягивается сама. Инструменты Timeline появляются только с пакетом com.unity.timeline, инструменты Recorder требуют com.unity.recorder и Timeline, а test_run и test_results требуют com.unity.test-framework. Сервер слушает только 127.0.0.1, каждый запрос кроме OPTIONS требует токен.
Как отключить. Удалите пакет в Package Manager Unity. Для CLI выполните isuzu-unity-cli uninstall, он уберет навык и записи клиентов. Запись сервера в конфигурации MCP-клиента удалите отдельно.
Частые вопросы
Как подключить UnityMCP к Claude Code?
Добавьте пакет через Package Manager по адресу репозитория, установите isuzu-unity-cli и выполните isuzu-unity-cli setup --mcp --agent claude-code. Claude Code запускайте из папки проекта Unity.
Как CLI находит запущенный редактор?
Редактор записывает адрес и токен в файл-дескриптор, и CLI читает его сам. Порт и токен вводить вручную не нужно.
Как добавить свой инструмент?
Напишите статический метод C# в редакторе и пометьте его атрибутом McpTool. Схема JSON строится по сигнатуре, и инструмент доступен и клиентам MCP, и CLI. Без C# можно описать инструмент в JSON-файле.
Что делает команда verify?
Объединяет пересборку после правки скрипта, сбор ошибок и чтение ошибок консоли в один вызов. С флагом --test заодно запускает тесты.
Что делать, если запущено несколько редакторов Unity?
Выберите нужный флагом --project с именем проекта. Внутри папки проекта выбор происходит автоматически.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыУправление редактором Unity из агента через MCP: сцены и объекты, C#-скрипты, ассеты, тесты, профилирование и сборка
MCP-сервер, который связывает AI-агента с редактором Unity: управление сценой, объектами, пакетами и ресурсами проекта
MCP-сервер для Unity: управление сценой, объектами, компонентами, сборками и профилировкой из агента
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
Плагин Unity с MCP-сервером, скиллами и CLI: агент управляет сценами, ассетами, скриптами и тестами в редакторе Unity
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| UnityMCP (эта запись) | нет | API-ключ | 338 | |
| Unity MCP Server | нет | не нужна | 529 | другой MCP-сервер для Unity со своим набором инструментов |
| MCP Unity | нет | не нужна | 2 006 | MCP-сервер для Unity на Node с отдельным процессом |
Коротко о README
Документация выходит на японском, английском и вьетнамском языках. Подробные руководства по группам инструментов, CLI и безопасности лежат в отдельных файлах репозитория.