UnrealGenAISupport MCP
Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора
- 679 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Выполняет произвольные скрипты Python и консольные команды Unreal в открытом редакторе
- Создает и меняет блупринты, материалы, уровни и файлы проекта, отмены действий нет
- Для вызовов моделей из игры ключи API лежат в переменных окружения PS_*, в собранной игре их хранить небезопасно
Установка
- Работает в
Ручная установка
git submodule add https://github.com/prajwalshettydev/UnrealGenAISupport Plugins/GenerativeAISupportЗатем создайте файлы проекта заново, включите плагин в Edit, Plugins и для C++ добавьте модуль GenerativeAISupport в Build.cs.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Выполняет произвольные скрипты Python и консольные команды Unreal в открытом редакторе
- Создает и меняет блупринты, материалы, уровни и файлы проекта, отмены действий нет
- Для вызовов моделей из игры ключи API лежат в переменных окружения PS_*, в собранной игре их хранить небезопасно
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UnrealGenAISupport — плагин для Unreal Engine 5.4–5.7 из двух частей. Первая дает C++ и Blueprint доступ к API OpenAI, Anthropic, xAI Grok и DeepSeek для чата и структурированных ответов. Вторая — MCP-сервер mcp_server.py на FastMCP, через который Claude Desktop, Claude Code или Cursor управляют открытым редактором. Через MCP агент создает блупринты, добавляет в них переменные, функции и компоненты, подключает узлы и компилирует результат. В уровне он спавнит объекты и блупринт-акторы, меняет свойства компонентов, создает материалы, папки проекта, GameMode, виджеты и привязки ввода. Отдельные инструменты execute_python_script и execute_unreal_command выполняют скрипты на Python и консольные команды, take_editor_screenshot делает снимок редактора, get_all_scene_objects перечисляет объекты сцены. Автор предупреждает, что MCP отдает агенту прямое управление проектом.
Для кого. Для разработчиков на Unreal Engine 5, которые хотят управлять редактором из Claude Desktop, Claude Code или Cursor и вызывать модели OpenAI, Anthropic, Grok и DeepSeek из игры.
Подходит, если
- Прототипу нужно быстро набросать сцену: агент спавнит формы, двигает, вращает и красит объекты через spawn_object и edit_component_property
- Нужно собрать каркас блупринта: переменные, функции, компоненты и компиляция без ручной возни в графе
- Надо выполнить в редакторе скрипт на Python или консольную команду, которую агент пишет по вашему описанию
- Игре нужен чат с моделью OpenAI, Anthropic, Grok или DeepSeek из C++ или Blueprint
- Для отчета нужен снимок редактора, который агент делает сам, и список объектов сцены
Не подходит, если
- Проект без резервной копии и версионного контроля: автор советует их перед работой с MCP
- Нужны сложные графы блупринтов: подключение узлов остается в списке известных проблем
- Нужна официальная интеграция Epic: автор указывает, что она готовится для Unreal Engine 5.8 и новее
- Нужен готовый бинарный файл: плагин подключается как подмодуль Git и собирается вместе с проектом
Пример запроса к агенту
Создай в открытом уровне красный куб над полом, добавь блупринт Door с булевой переменной IsOpen и функцией Toggle и скомпилируй егоMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
UNREAL_HOST- Адрес, по которому MCP-сервер ищет редактор Unreal, в примере localhost
UNREAL_PORT- Порт связи с редактором, в примере 9877
Ограничения
- MCP-часть требует Python с пакетом fastmcp и включенного в редакторе плагина Python Editor Script Plugin.
- Автор пишет, что MCP в бесплатном плагине не развивается. Известные проблемы: узлы блупринтов подключаются с ошибками, сложные материалы не создаются, при компиляции блупринта агент не получает внятного описания ошибок.
- Часть API-вызовов (чат с моделями) требует ключей OpenAI, Anthropic, xAI или DeepSeek, а API OpenAI и Anthropic из России недоступны. Для MCP через Claude-приложение ключ API не нужен.
- Ключи в собранной игре хранить небезопасно, автор советует вызывать модели через собственный сервер.
- Платные плагины с большим набором моделей продаются отдельно на Fab, этот репозиторий покрывает только четырех провайдеров.
Как отключить. Уберите сервер unreal-handshake из claude_desktop_config.json, .mcp.json или .cursor/mcp.json и перезапустите клиент. Чтобы снять плагин, выключите его в Edit, Plugins и удалите подмодуль Plugins/GenerativeAISupport. Включенную автозагрузку MCP-сервера в настройках редактора выключите отдельно.
Частые вопросы
Как подключить Unreal Engine к Claude Code через MCP?
Подключите плагин как подмодуль Git, включите его вместе с Python Editor Script Plugin и поставьте fastmcp. Затем добавьте в .mcp.json сервер unreal-handshake с командой python, путем к Content/Python/mcp_server.py и переменными UNREAL_HOST и UNREAL_PORT. Для Claude Desktop и Cursor меняется только файл настройки.
Какой порт использует MCP-сервер для Unreal?
В примерах конфигурации указан UNREAL_HOST=localhost и UNREAL_PORT=9877. Эти значения передаются серверу через переменные окружения. Автозапуск MCP при открытии редактора включается отдельной настройкой плагина.
Нужен ли ключ API, чтобы управлять Unreal через Claude?
Нет. Для MCP-функций в приложении Claude ключ Anthropic не нужен. Ключи нужны, когда игра сама вызывает модели из C++ или Blueprint, и тогда их задают переменными окружения вида PS_OPENAIAPIKEY, PS_ANTHROPICAPIKEY, PS_DEEPSEEKAPIKEY.
Какие версии Unreal Engine поддерживает плагин?
Поддержка MCP рассчитана на Unreal Engine 5.4–5.7 и новее. Платные плагины автора заявляют версии 5.1–5.7 и новее. Для 5.8 автор ждет официальную интеграцию Epic и отдельно советует посмотреть UnrealClaude.
Чем опасен MCP для проекта Unreal?
Агент получает прямое управление редактором, включая выполнение Python и консольных команд, а отмены действий нет. Автор рекомендует использовать MCP только в контролируемой среде.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПлагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
MCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
Unreal MCP на Python: 253 действия в 21 области, от акторов и Blueprint до материалов и кинематографики, плюс выполнение любого Python в редакторе
MCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
Официальный плагин Epic Games: Claude Code управляет открытым Unreal Editor по MCP, от акторов и Blueprint до Niagara и Sequencer
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| UnrealGenAISupport (эта запись) | нет | не нужна | 679 | |
| Unreal MCP | нет | не нужна | 2 108 | отдельный MCP-сервер для редактора Unreal, без вызова моделей из игры на C++ и Blueprint |
| UnrealClaude | нет | не нужна | 973 | плагин приносит Claude Code прямо в редактор Unreal 5.7 вместе с контекстом документации движка |
| AI Game Developer: Unreal MCP | нет | OAuth | 52 | плагин с MCP, который ведет редактор через язык запросов RQL, правит Blueprint и C++ |
Коротко о README
README начинается с двух примеров: Claude спавнит объекты и создает блупринты через MCP, и демо с NPC на агентах OpenAI. Дальше автор рекламирует платные плагины на Fab и описывает бесплатные возможности репозитория: чат с OpenAI, Anthropic, Grok и DeepSeek и статус функций MCP. Затем идут настройка ключей через переменные PS_ИМЯ, подключение MCP для Claude Desktop, Claude Code и Cursor, добавление плагина подмодулем Git, примеры вызовов на C++ и Blueprint и список известных проблем.