Unreal MCP (GenOrca)
Unreal MCP на Python: 253 действия в 21 области, от акторов и Blueprint до материалов и кинематографики, плюс выполнение любого Python в редакторе
- 146 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Инструмент execute_python выполняет произвольный Python в Unreal Editor с доступом ко всему движку и проекту
- Агент удаляет и переименовывает ассеты и акторы проекта на диске
Установка
- Работает в
Ручная установка
{"mcpServers": {"unreal-mcpython": {"command": "uv", "args": ["--directory", "C:/absolute/path/to/unreal-mcp/mcp-server", "run", "src/unreal_mcp/main.py"]}}}Замените путь на абсолютный путь к папке mcp-server из архива. Для VS Code и Cursor используется .vscode/mcp.json.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент execute_python выполняет произвольный Python в Unreal Editor с доступом ко всему движку и проекту
- Агент удаляет и переименовывает ассеты и акторы проекта на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин Unreal-MCPython и MCP-сервер на Python связывают ассистента с Unreal Editor. По описанию проекта, в нем 253 действия в 21 области. Среди них акторы (36 действий), ассеты, материалы, Blueprint, анимация, UMG-виджеты, Level Sequence, Behavior Tree, Gameplay Ability System, DataTable, Control Rig и ретаргетинг. Устройство компактное: каждая область — один инструмент MCP, а нужное действие передают в поле action вместе с параметрами. Команда list_actions у любой области показывает все действия и их параметры, поэтому список инструментов не раздувает контекст модели. Для всего, чего нет в готовом наборе, есть execute_python в области util: он выполняет любой Python с доступом к API движка. Отдельные инструменты vision снимают вид из вьюпорта и возвращают картинки с подписями акторов, чтобы ассистент видел сцену. Новое действие добавляют функцией на Python и запуском generate_catalog.py, без сборки C++.
Для кого. Для разработчиков и технических художников на Unreal Engine 5.6 и новее, которым нужен unreal mcp для сцены, Blueprint и материалов из Claude Desktop, Cursor или VS Code.
Подходит, если
- Нужно расставить деревья по поверхности ландшафта или найти все статические меши с заданным словом в имени
- Агент должен собрать материал из выражений, подключить их к свойствам и создать экземпляры
- Требуется построить Behavior Tree, виджет HUD или Level Sequence с камерой по описанию
- Нужно импортировать FBX, текстуры или glTF и управлять метаданными ассетов
- Хочется добавлять свои действия функциями на Python без пересборки редактора
Не подходит, если
- У вас Unreal Engine старше 5.6: проект требует версию 5.6 и новее
- Нужна быстрая установка без поиска архива под свою версию движка: готовые сборки привязаны к версии
- Редактор нельзя трогать из-за выполнения произвольного кода: execute_python запускает любой Python в движке
- Нужен только небольшой набор команд: здесь 253 действия в 21 области
Пример запроса к агенту
Создай материал M_Ground, добавь Constant3Vector для базового цвета и подключи его, затем размести десять деревьев на поверхности ландшафта.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Unreal Engine 5.6 или новее, Python 3.11 или новее, менеджер uv и включенные плагины Unreal-MCPython и Python Editor Script Plugin. Готовые архивы собраны под конкретную версию движка, а исходный архив требует Visual Studio с нагрузкой для C++, иначе сборка падает и редактор закрывается. Путь к папке mcp-server в конфигурации клиента задают абсолютным. Лицензия Apache-2.0. Работа из России не проверялась: сервер локальный и ключей не требует.
Как отключить. Удалите запись unreal-mcpython из конфигурации клиента и отключите плагин Unreal-MCPython в Edit, Plugins с перезапуском редактора.
Частые вопросы
Как установить Unreal MCP от GenOrca?
Скачайте из релизов архив UnrealMCPython под свою версию движка, скопируйте Plugins/UnrealMCPython в проект и включите плагины. Затем добавьте в конфигурацию клиента сервер с командой uv --directory <путь к mcp-server> run src/unreal_mcp/main.py.
Какая версия Unreal Engine нужна для этого unreal mcp?
Unreal Engine 5.6 или новее. Готовые архивы собираются под конкретную версию, например 5.8.
Сколько инструментов в Unreal MCP от GenOrca?
Каждая из областей — один инструмент MCP, а действия передаются в поле action. По описанию проекта, всего 253 действия в 21 области, а execute_python закрывает все остальное.
Как узнать параметры действия?
Вызовите у области действие list_actions. Оно вернет список действий с параметрами и описанием.
Чем он отличается от других Unreal MCP в каталоге?
Это отдельный проект на Python с областями-инструментами, готовыми архивами под версию движка, снимками вьюпорта для ассистента и добавлением своих действий без сборки C++.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера
Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
MCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора
Плагин Unreal Engine 5.7 и 5.8 с MCP-сервером: агент работает с Blueprint, материалами и Niagara через 26 пространств имен
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Unreal MCP (GenOrca) (эта запись) | нет | не нужна | 146 | |
| Unreal MCP | нет | не нужна | 2 110 | другой MCP-сервер для Unreal Engine со своим плагином и набором команд |
| Unreal Engine MCP Server | нет | не нужна | 995 | другой MCP-сервер для Unreal Engine с управлением ассетами и актерами |
| UnrealClaude | нет | не нужна | 973 | плагин, который приносит Claude Code внутрь редактора Unreal |
Коротко о README
Описание перечисляет области и число действий в каждой в таблице, объясняет схему «один инструмент на область» и пример вызова. Дальше идет раздел о расширении проекта функцией на Python, установка плагина из релиза или из исходников, включение плагинов, настройка клиента и расположение конфигураций для Claude Desktop и VS Code. В конце даны примеры запросов, полный справочник действий по областям и устранение неполадок.