Об этом проекте

Unreal Engine MCP Server — это сервер Model Context Protocol, позволяющий ИИ-ассистентам управлять Unreal Engine 5 через нативный C++ плагин Automation Bridge. Он написан на TypeScript и C++, опубликован на npm как unreal-engine-mcp-server и распространяется под лицензией MIT. Возможности сгруппированы по областям: управление ассетами (просмотр, импорт, дублирование, переименование, удаление, создание материалов), управление акторами (спавн, удаление, трансформация, физика, теги, компоненты), управление редактором (сессии PIE, камера, вьюпорт, скриншоты, закладки), управление уровнями (загрузка/сохранение, стриминг, освещение), анимация и физика (анимационные блюпринты, машины состояний, рэгдоллы, транспортные средства, ограничения), визуальные эффекты (частицы Niagara, GPU-симуляции, отладочные фигуры), Sequencer (кинематографика, управление таймлайном, Movie Render Queue, медиа, Take Recorder, воспроизведение), редактирование графов (Blueprint, Niagara, Material, Behavior Tree), аудио (звуковые сигналы, компоненты, миксы, фоновые звуки) и системные операции (консольные команды, UBT, тесты, логи, настройки проекта, CVars). Предлагаются два транспорта. Нативный транспорт MCP — это встроенный в плагин сервер Streamable HTTP/SSE, доступный по адресу http://localhost:3000/mcp, не требующий Node.js, npm или моста. TypeScript-мост — это stdio-сервер, который общается с плагином через WebSocket. Оба предоставляют один и тот же единый шлюзовый инструмент unreal с четырьмя операциями: search, describe, execute и configure. 23 канонических родительских инструмента являются внутренними и доступны только через шлюз; прямые вызовы канонических имён возвращают уведомление о миграции с предложением следующего вызова. Согласование версии протокола различается между двумя поверхностями, при этом нативный транспорт поддерживает только более новые версии. Для настройки требуется Node.js 20.19 или новее для TypeScript-моста, а также установленный плагин McpAutomationBridge — либо путём копирования его в папку Plugins проекта, либо добавления внешнего каталога плагинов, либо использования предварительно собранных бинарников, привязанных к конкретной версии движка. Установки из исходников требуют цели кода; проекты только с Blueprint должны сначала добавить C++ класс. Требуется несколько основных плагинов (Python Editor Script Plugin, Editor Scripting Utilities, Niagara, Gameplay Abilities, Smart Objects), а многие необязательные плагины автоматически включаются при необходимости. Заявлена поддержка версий движка с 5.0 по 5.8. Конфигурация использует переменные окружения, такие как UE_PROJECT_PATH, MCP_AUTOMATION_HOST, MCP_AUTOMATION_PORT, тайм-ауты, уровень логирования и дополнительные префиксы путей к контенту. Доступ по локальной сети по умолчанию отключён и должен быть явно включён, с предупреждением о безопасности. Аутентификация по токену возможностей включена по умолчанию и использует автоматически сгенерированный файл секрета или вручную настроенный токен. Среди других отмеченных особенностей — динамическое обнаружение типов, корректный запуск без активного подключения к Unreal, повторные попытки рукопожатия с экспоненциальной задержкой, блокировка опасных консольных команд, 10-секундный кэш ассетов и ограничение скорости по IP на конечной точке метрик Prometheus. Включён Dockerfile, а в репозитории описаны скрипты разработки для сборки, линтинга, проверки типов, модульных тестов, дымовых тестов, проверок дрейфа манифеста, тестов нативного паритета, аудита параметров и проверок версий, а также CI-гейты и скрипт генерации манифеста шлюза. Документация охватывает справочник действий, архитектуру расширения плагина, тестирование и дорожную карту.