Unreal_mcp

Unreal_mcp — MCP-сервер сообщества (автор — ChiR24). Управление Unreal Engine: просмотр и импорт ассетов, работа с уровнями и секвенциями. Ставится через Docker. Доступен и как удалённый сервер. Лицензия MIT.

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

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

Разработчик
ChiR24
Лицензия
MIT
Транспорт
streamable_http
Авторизация
token_env
ОС
Не указана
Языки
c++

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

Меняет проект Unreal (акторы, ассеты, Blueprints), может запускать Python и сборку; удаления требуют consentGrant; только 127.0.0.1 и токен проекта.

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

claude-code
{
    "code": "{\n  \"mcpServers\": {\n    \"unreal-engine\": {\n      \"type\": \"http\",\n      \"url\": \"http://127.0.0.1:3000/mcp\",\n      \"headers\": { \"X-MCP-Capability-Token\": \"${UNREAL_MCP_TOKEN}\" }\n    }\n  }\n}",
    "file": ".mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

EngineWire (репозиторий Unreal_mcp) подключает Claude, Cursor, VS Code и другие MCP-клиенты к запущенному Unreal Editor через нативный плагин на C++. Ассистент может строить уровни, Blueprints, интерфейсы, материалы, эффекты и многое другое. Поддерживаются Unreal Engine с 5.0 по 5.8. Описание ниже относится к стабильной версии 0.6.0.

Возможности:

  • Уровни и акторы — создание одного или сотен акторов за вызов, размещение и привязка, поиск провалившихся в пол, загрузка, стриминг и сохранение уровней.
  • Blueprints и интерфейс — Blueprints, переменные, компоненты, целые графы событий за один пакет, виджеты UMG с превью.
  • Материалы и мир — графы материалов и инстансы, процедурные текстуры, освещение, ландшафты, растительность, эффекты Niagara и графы PCG.
  • Геймплей — персонажи и анимация, Gameplay Ability System, ИИ (Behavior Trees, State Trees, EQS), инвентарь, сеть, Enhanced Input.
  • Синематики и звук — Level Sequences, камеры, Movie Render Queue, Take Recorder, Sound Cues и MetaSounds.
  • Запуск и проверка — Play-In-Editor с синтетическим вводом, скриншоты, которые видит модель, логи, профилирование, запуск Python и сборка проекта.

Больше 450 возможностей скрыты за одним MCP-инструментом unreal с четырьмя операциями: search (поиск возможности по 2–4 словам), describe (точный контракт), execute (запуск с проверкой параметров и отчётом об изменениях) и configure. Поэтому в контекст модели загружается только нужная схема, а не сотни.

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

  • Разработчикам игр на Unreal Engine: черновая сборка уровней, Blueprints и интерфейса по описанию.
  • Техническим художникам: материалы, освещение, Niagara и PCG через ассистента.
  • Командам: несколько клиентов могут работать с одним редактором по HTTP.

Похожие серверы — в категории 3D и геймдев.

Установка

  1. Установите плагин EngineWire. Из Fab компилятор не нужен: «Install to Engine» в Epic Games Launcher. Можно и из релиза на GitHub: распакуйте папку EngineWire в MyGame/Plugins/EngineWire/.
  2. Откройте проект. Строка состояния покажет MCP :3000 (0) — плагин обслуживает MCP на порту 3000.
  3. Выберите способ подключения:
    • HTTP (Node.js не нужен). Клиент подключается к http://127.0.0.1:3000/mcp и передаёт токен из <проект>/Saved/MCP/capability-token в заголовке X-MCP-Capability-Token. В сборке 0.6.0 из Fab нативный сервер по умолчанию выключен: включите его в Project Settings › Plugins › EngineWire.
    • stdio (Node.js 20.19+). Прокси unreal-engine-mcp-server сам находит токен по UE_PROJECT_PATH и переживает перезапуски редактора.

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

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

.mcp.json
{
  "mcpServers": {
    "unreal-engine": {
      "type": "http",
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "X-MCP-Capability-Token": "${UNREAL_MCP_TOKEN}" }
    }
  }
}

Для Claude Code токен берётся из переменной окружения UNREAL_MCP_TOKEN. В Cursor (.cursor/mcp.json) указываются те же url и headers, но без type. Инструкции для VS Code и Windsurf есть в вики проекта.

Проверка

При подключении клиента счётчик в строке состояния редактора увеличивается: MCP :3000 (1). Затем попросите ассистента показать акторы текущего уровня или сделать скриншот вьюпорта.

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

Создай точечный источник света на 300 единиц выше начала координат.
Собери простой уровень платформера из кубов и сделай скриншот вьюпорта.

Риски

Ассистент меняет проект Unreal: создаёт и удаляет акторы и ассеты, правит Blueprints, сохраняет уровни, а также может запускать Python и сборку проекта. Работайте в проекте под контролем версий. Защита по README:

  • оба способа подключения слушают только 127.0.0.1, а у нативного сервера нет TLS — для удалённого доступа используйте SSH-туннель;
  • токен генерируется для каждого проекта и сравнивается за постоянное время. Чтобы сменить его, удалите файл и перезапустите редактор;
  • удаления и часть рискованных записей требуют разового consentGrant из describe;
  • пути ассетов ограничены каталогами /Game, /Engine, /Script, /Temp и /Niagara.

Токен — это фактически пароль: храните его в переменной окружения и не коммитьте.

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

Нужен ли Node.js?

Для HTTP-подключения нет. Node.js 20.19+ нужен только для stdio-прокси, например для Claude Desktop.

Какие версии Unreal Engine поддерживаются?

С 5.0 по 5.8.

Основы протокола — на странице что такое 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

Источники