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; неофициальный проект.
Настройка клиентов
{
"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.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
MCP Unity
Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.