UE-MCP
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
- 455 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает запись в проект Unreal: создает, меняет и удаляет ассеты, акторы и графы Blueprint
- Через сервер доступны консоль редактора, выполнение Python, сборка проекта и запуск или остановка самого редактора
- Мост работает внутри редактора как скомпилированный C++-плагин, а расширения из npm добавляют в него свои обработчики, и этот код тоже выполняется
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ue-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает запись в проект Unreal: создает, меняет и удаляет ассеты, акторы и графы Blueprint
- Через сервер доступны консоль редактора, выполнение Python, сборка проекта и запуск или остановка самого редактора
- Мост работает внутри редактора как скомпилированный C++-плагин, а расширения из npm добавляют в него свои обработчики, и этот код тоже выполняется
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UE-MCP соединяет ИИ-агента с Unreal Editor. Сервер на TypeScript запускается через npx и общается по WebSocket с C++-плагином, который работает внутри редактора. Через этот мост агент читает и меняет уровни, Blueprint, материалы, анимацию, Niagara, ландшафт, PCG, звук, интерфейсы UMG и сетевые настройки, а еще запускает сборку проекта. Команда `npx ue-mcp init` находит файл .uproject, дает выбрать категории инструментов, кладет мост в проект, включает нужные плагины Unreal и прописывает сервер в конфиге клиента: Claude Code, Claude Desktop, Cursor или Codex. Чтение INI-настроек, заголовков C++ и списка ассетов работает и при закрытом редакторе, так что агент может изучить проект до запуска. Повторяющиеся последовательности записываются как YAML-потоки в файле ue-mcp.yml рядом с .uproject и запускаются одним вызовом, с повторами и откатом. Расширения ставятся из npm и добавляют действия в готовые категории. Вместе с пакетом идут скиллы ue-mcp-workflow, ue-mcp-blueprint, ue-mcp-niagara и другие: они объясняют порядок работы с редактором, графы Blueprint, Niagara и нативный C++.
Для кого. Для разработчиков и технических художников на Unreal Engine, которые хотят поручить Claude Code, Cursor или Codex рутину в редакторе: расстановку объектов, настройку материалов, графы Blueprint и сборку проекта.
Подходит, если
- Нужно поставить на уровень точечный свет на 300 единиц выше места старта игрока с яркостью 5000 и теплым белым цветом, не открывая панели свойств
- Нужен эмиссивный пульсирующий материал, который сразу ложится на все кубы уровня
- Проект надо собрать в конфигурации Development, а ошибки компиляции должен прочитать и пересказать агент
- Вы собираете сцену с ландшафтом, PCG-рассадкой и эффектами Niagara и хотите повторять ее шаги одним YAML-потоком
- Редактор пока закрыт, а агенту надо изучить INI-настройки, заголовки C++ и список ассетов проекта
Не подходит, если
- Проект на Unreal Engine ниже 5.4: заявленный диапазон начинается с 5.4
- На машине нет компилятора C++: мост собирается при первом запуске редактора
- Проект на другом движке, например Unity или Godot: нужен другой сервер
- Вам нужен только набор подсказок для агента без доступа к редактору: скиллы пакета рассчитаны на работу через мост
Пример запроса к агенту
Проверь подключение UE-MCP и расскажи, что сейчас на уровне. Потом поставь точечный свет на 300 единиц выше места старта игрока, яркость 5000, теплый белыйMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
UE_EDITOR_PATH- Путь к редактору, если движок установлен в нестандартную папку
Ограничения
- Мост — C++-плагин, и он компилируется при первом запуске редактора. На Windows нужна Visual Studio с нагрузкой C++, на macOS инструменты командной строки Xcode.
- Поддержаны версии 5.4–5.8 на Windows и 5.6 и новее на Linux и macOS. Категория epic с родными инструментами Epic, а также Dataflow и Conversation требуют версию 5.8 или новее.
- После init редактор надо перезапустить один раз, иначе мост не загрузится. Если связи нет, помогает `npx ue-mcp doctor`.
- Нужны Node.js 18 или новее и PythonScriptPlugin, который входит в состав движка.
- Агент с записью в проект меняет ассеты и уровни. Защитные правила могут блокировать изменяющие методы или требовать подтверждения, а проверка состояния системы контроля версий не дает молча перезаписать зарегистрированные ассеты. Оба механизма настраиваются отдельно.
Как отключить. Уберите запись ue-mcp из конфига MCP-клиента, и агент перестанет видеть сервер. Мост остается в проекте как C++-плагин: отключите его в списке плагинов проекта, удалите его папку и пересоберите проект.
Частые вопросы
Как поставить UE-MCP в Claude Code?
Откройте терминал в папке с файлом .uproject и выполните `npx ue-mcp init`. Мастер найдет проект, развернет мост и определит клиента, в том числе Claude Code. После этого один раз перезапустите редактор. Вручную сервер подключают записью с командой npx и аргументами `-y`, `ue-mcp@latest` и путем к .uproject.
Что делать, если UE-MCP не подключается к редактору?
Запустите `npx ue-mcp doctor`. Причина обычно одна из трех: редактор не перезапускали после init, мост не скомпилировался (ошибку покажет Output Log по метке UE_MCP_Bridge) или открыт другой проект, чем в конфиге.
Какие версии Unreal Engine поддерживает UE-MCP?
Для Windows подходят версии 5.4–5.8, для Linux и macOS версия 5.6 или новее. Родные инструменты Epic, а также категории Dataflow (графы данных) и Conversation (диалоговые графы) работают с версии 5.8.
Работает ли UE-MCP при закрытом редакторе?
Частично. Чтение INI-настроек, заголовков C++ и списка ассетов идет прямо с диска. Изменения уровней, Blueprint и материалов проходят через мост внутри редактора, поэтому ему надо быть запущенным. Запускать и останавливать сам редактор агент тоже умеет, путь к движку задает переменная UE_EDITOR_PATH.
Как записать цепочку действий и запускать ее одним вызовом?
Опишите шаги в разделе flows файла ue-mcp.yml рядом с .uproject и вызовите инструмент flow с действием run и именем потока. Файл перечитывается на лету. В потоках есть ссылки между шагами, повторы, откат и собственные задачи на .js или .ts.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера
MCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
Unreal MCP на Python: 253 действия в 21 области, от акторов и Blueprint до материалов и кинематографики, плюс выполнение любого Python в редакторе
Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора
Расширение MCP и набор редакторских инструментов для Unreal Engine 5.8+: агент управляет редактором через ландшафт, материалы, анимацию, Niagara, UMG
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| UE-MCP (эта запись) | нет | не нужна | 455 | |
| Unreal MCP | нет | не нужна | 2 108 | тоже ведет редактор через MCP, но без потоков YAML и расширений из npm, которые есть у UE-MCP |
| Unreal MCP (GenOrca) | нет | не нужна | 146 | сервер на Python с 253 действиями, у UE-MCP сервер на TypeScript, мост на C++ и потоки YAML |
| Unreal Engine Skills for Claude Code | да | 1 724 | официальный плагин Epic для Claude Code, UE-MCP работает с несколькими клиентами и подключает инструменты Epic как часть своих категорий |
Коротко о README
Страница репозитория открывается быстрым стартом и ручной настройкой клиента, потом показывает демо из 19 шагов: оно строит сцену с ландшафтом, PCG, Niagara и играбельным Blueprint. Дальше идут таблица категорий, разделы про потоки, плагины и защитные механизмы, затем требования. Полная документация вынесена на сайт проекта.