UE-MCP — Управляйте Unreal Editor через естественный язык
UE-MCP (Unreal Engine Model Context Protocol Server) — это сервер на TypeScript, который подключает AI-ассистентов (Claude, Cursor и другие) прямо к Unreal Editor. Через 19 категорий инструментов и более 300 действий AI может читать и изменять проект: от создания уровней и материалов до настройки анимации, VFX, GAS и билдов.
Схема работы:
- AI-ассистент ↔ (stdio) ↔ MCP-сервер ↔ (WebSocket / JSON-RPC) ↔ C++ Bridge Plugin внутри Unreal Editor
- MCP-сервер также имеет прямой доступ к файловой системе: config INI, C++-заголовки, список ассетов.
Быстрый старт
npx ue-mcp init
Интерактивный установщик:
- Находит .uproject в текущей папке (или укажите путь)
- Позволяет выбрать нужные категории инструментов
- Развёртывает C++ Bridge Plugin в ваш проект
- Включает необходимые плагины UE (Niagara, PCG, GAS и др.)
- Определяет и настраивает ваш MCP-клиент (Claude Code, Claude Desktop, Cursor)
- После завершения — перезапустите редактор для загрузки Bridge Plugin.
Для обновления используйте:
npx ue-mcp update
После установки вызовите AI и попробуйте:
project(action="get_status") — проверить соединение
level(action="get_outliner") — посмотреть содержимое уровня
asset(action="list") — просмотреть ассеты проекта
Ручная настройка (если не используете init)
Добавьте в конфигурацию MCP-клиента:
{
"mcpServers": {
"ue-mcp": {
"command": "npx",
"args": ["ue-mcp", "C:/path/to/MyGame.uproject"]
}
}
}
Что умеет?
| Категория |
Примеры возможностей |
| Уровни |
Размещение/перемещение/удаление актёров, спавн светильников и объемов, работа со сплайнами |
| Blueprints |
Чтение/запись графов, добавление узлов, соединение пинов, компиляция |
| Материалы |
Создание материалов и инстансов, редактирование графов выражений |
| Ассеты |
CRUD, импорт мешей/текстур/анимаций, работа с дататейблами |
| Анимация |
Anim Blueprints, монтажи, блендспейсы, скелеты |
| VFX |
Niagara-системы, эмиттеры, параметры |
| Ландшафт |
Скульптинг, покраска слоёв, импорт карт высот |
| PCG |
Создание и выполнение графов процедурной генерации |
| Геймплей |
Физика, коллизии, навигация, Behaviour Trees, EQS, перцепция |
| GAS |
Gameplay Ability System — атрибуты, способности, эффекты, кубики |
| Сеть |
Репликация, дорманси, релеванси, сетевой приоритет |
| UI |
UMG-виджеты, редакторские utility виджеты и блюпринты |
| Редактор |
Консоль, Python, PIE, вьюпорт, секвенсор, пайплайн сборки, логи |
| Рефлексия |
Интроспекция классов/структур/енумов, игровые теги |
Поддерживаемые платформы
- Windows: UE 5.4–5.7
- Linux: UE 5.6+ (спасибо @robinduckett)
Требуется плагин PythonScriptPlugin (входит в состав UE с версии 4.26).
Документация
Полная документация: db-lyon.github.io/ue-mcp
Участие в разработке
Принимаются issues и pull requests. Если AI-агент во время сессии переключился на execute_python (обходной путь), он автоматически предложит отправить структурированный отзыв — это помогает разработчикам понять, какие нативные хендлеры нужны в первую очередь.
Лицензия: MIT — см. LICENSE.
Комментарии
Комментариев пока нет. Будьте первым.