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 и токен проекта.
Настройка клиентов
{
"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 и геймдев.
Установка
- Установите плагин EngineWire. Из Fab компилятор не нужен: «Install to Engine» в Epic Games Launcher. Можно и из релиза на GitHub: распакуйте папку
EngineWireвMyGame/Plugins/EngineWire/. - Откройте проект. Строка состояния покажет
MCP :3000 (0)— плагин обслуживает MCP на порту 3000. - Выберите способ подключения:
- 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и переживает перезапуски редактора.
- HTTP (Node.js не нужен). Клиент подключается к
Подключение к клиентам
Конфиги приведены дословно из README. Общий порядок — в инструкции как подключить MCP.
{
"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.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
MCP Unity
Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.