unreal-mcp-ue4

unreal-mcp-ue4 — MCP-сервер сообщества (автор — conaman). Управление редактором Unreal Engine 4.27 через Python Remote Execution. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
conaman
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

Управление редактором UE 4.27 через Python Remote Execution; неофициальный проект.

Настройка клиентов

codex
{
    "code": "codex mcp add unreal-ue4 -- unreal-mcp-ue4",
    "lang": "bash",
    "verified": "docs"
}

Неофициальный проект в активной разработке. Это не проект Epic Games; автор предупреждает, что возможны ошибки, недоработки и ограничения, характерные для UE 4.27.

Что умеет

unreal-mcp-ue4 — MCP-сервер для Unreal Engine 4.27.2, работающий через встроенный в редактор механизм удалённого выполнения Python. Собственный плагин на C++ из репозитория не нужен. Проект вырос из идеи runreal/unreal-mcp, но сильно переработан под UE4: добавлены новые инструменты, слои совместимости, документация и проверочные сценарии. По словам автора, при разработке помогал Codex.

Что умеет сервер в открытом редакторе:

  • читать сведения о проекте, карте, ассетах и акторах;
  • создавать, осматривать, перемещать и удалять акторы на текущем уровне;
  • искать ассеты, смотреть ссылки и метаданные;
  • создавать типовые ассеты данных — DataAsset, StringTable;
  • создавать и править Blueprint-ассеты там, где Python в UE 4.27 даёт нужные API;
  • создавать и править деревья Widget Blueprint с безопасными для UE 4.27 помощниками UMG;
  • работать с секвенсором, если включён SequencerScripting.

Основной интерфейс — пространства инструментов manage_* с параметрами action и params; для каждого действия публикуется своя схема входных данных. Отправные точки чтения — manage_editor.project_info, manage_editor.map_info и manage_level.world_outliner. Для отладки и пробелов в API есть «запасной выход» manage_editor.run_python. Функции, доступные только в UE5, не возвращаются: ненадёжные сценарии либо исключены, либо возвращают понятное сообщение вместо тихого сбоя. Например, просмотр графа Blueprint и соединение пинов в стандартном Python UE 4.27 недоступны.

Кому подойдёт

Разработчикам игр на Unreal Engine 4.27, которые хотят поручать агенту рутинные действия в редакторе: расстановку акторов, создание ассетов, сборку интерфейсов. Похожие серверы — в категории разработка.

Установка

Нужны Unreal Engine 4.27.2, Node.js 18+ и npm. Рекомендуемая установка — npm install -g unreal-mcp-ue4. Затем в редакторе включите плагины Python Editor Script Plugin и Editor Scripting Utilities, а в настройках проекта в разделе Python — Enable Remote Execution, и перезапустите редактор. Проект должен оставаться открытым, пока работает сервер.

Подключение к клиентам

Конфигурации из README для глобальной установки через npm. Подробнее — в инструкции как подключить MCP.

claude mcp add --scope user unreal-mcp-ue4 -- unreal-mcp-ue4

Для GitHub Copilot в VS Code конфигурация кладётся в .vscode/mcp.json; затем запустите сервер из интерфейса настроек MCP и убедитесь, что unreal-ue4 появился в списке инструментов. При работе из исходников вместо команды указывается node и путь к dist/bin.js.

Проверка

Начните с команды только для чтения: «Получи сведения о проекте с сервера unreal-ue4».

Примеры задач

Перечисли акторов на текущем уровне.
Создай StaticMeshActor с именем TestCube в точке 0,0,100.

Риски

  • Изменение проекта. Любой подключённый клиент может просматривать и менять открытую сессию редактора; автор советует сначала пробовать на одноразовом тестовом проекте.
  • Выполнение кода. manage_editor.run_python выполняет произвольный Python внутри редактора.

Частые вопросы

Работает ли с UE5?

Сервер рассчитан на UE 4.27.2.

Нужен ли отдельный плагин?

Нет, используются встроенные плагины Python и Editor Scripting Utilities.

Как проверить версию сервера?

Командой unreal-mcp-ue4 --version.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники