Repolode
ChiR24

ChiR24/Unreal_mcp

MCP-сервер с нативным C++-плагином для Unreal Editor, который позволяет AI-ассистентам создавать уровни, Blueprint, материалы и многое другое в запущенном редакторе.

Звёзды
958
Форки
184
Открытые issues
15
Последний коммит
вчера

Что это?

EngineWire подключает MCP-совместимые AI-клиенты, такие как Claude, Cursor и VS Code, к запущенному Unreal Editor. Нативный плагин редактора на C++ выполняет операции в игровом потоке редактора, а TypeScript-сервер предоставляет подключение через stdio для клиентов, которые запускают только локальные команды. Оба способа подключения предоставляют один MCP-инструмент — unreal — с операциями поиска, описания, выполнения и настройки для почти 400 возможностей.

Возможности охватывают уровни и акторов, Blueprint и виджеты UMG, материалы, ландшафты, растительность, эффекты Niagara, графы PCG, Gameplay Ability System, AI (Behavior Trees, State Trees, EQS), Level Sequences, аудио и сборку пакетов. Параметры проходят строгую проверку, для разрушительных операций требуется разрешение, а редактор может делать скриншоты и запускать сессии Play-In-Editor, чтобы ассистент мог проверить результат.

Плагин поддерживает Unreal Engine с версии 5.0 по 5.8. Все компоненты прослушивают только 127.0.0.1; по умолчанию для каждого проекта требуется токен доступа к возможностям.

Ключевые возможности

  • 01Предоставляет один MCP-инструмент с операциями поиска, описания, выполнения и настройки.
  • 02Работает непосредственно в Unreal Editor через Streamable HTTP или мост stdio-to-WebSocket.
  • 03Охватывает уровни, Blueprint, UMG, материалы, Niagara, PCG, AI и Level Sequences.
  • 04Строго проверяет параметры и требует разрешения на разрушительные действия.
  • 05Прослушивает только localhost и по умолчанию требует токен доступа к возможностям.

Сценарии использования

  • Позволяет AI-ассистенту создавать акторов, размещать источники света и планировать уровень по запросу в чате.
  • Генерировать графы событий Blueprint или макеты виджетов UMG пакетно.
  • Проверять сборку в редакторе с помощью скриншотов и сессий Play-In-Editor, запущенных ассистентом.
  • Совместно использовать один запущенный редактор нескольким MCP-клиентам команды.

Быстрый старт

  1. 1

    Скачайте ZIP-архив плагина из предварительного релиза v0.6 на странице Releases

  2. 2

    Скопируйте папку EngineWire в каталог Plugins вашего проекта

    MyGame/Plugins/EngineWire/
  3. 3

    Включите Enable Native MCP Server в Project Settings, затем перезапустите редактор

  4. 4

    Добавьте сервер в Claude Code с помощью capability token

    claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"

Что важно знать

  • Требуется Unreal Engine 5.0–5.8 и проект с кодом на C++ либо предварительно собранные бинарные файлы для проектов только с Blueprint.
  • Предварительно собранные бинарные файлы работают только с той минорной версией движка и на той платформе, для которых они были собраны.
  • В README описана бета-линейка 0.6; у предыдущего стабильного релиза 0.5.30 другая структура инструментов.

Темы

Частые вопросы

Что такое Unreal_mcp?
MCP-сервер с нативным C++-плагином для Unreal Editor, который позволяет AI-ассистентам создавать уровни, Blueprint, материалы и многое другое в запущенном редакторе. EngineWire подключает MCP-совместимые AI-клиенты, такие как Claude, Cursor и VS Code, к запущенному Unreal Editor. Нативный плагин редактора на C++ выполняет операции в игровом потоке редактора, а TypeScript-сервер предоставляет подключение через stdio для клиентов, которые запускают только локальные команды. Оба способа подключения предоставляют один MCP-инструмент — unreal — с операциями поиска, описания, выполнения и настройки для почти 400 возможностей.
Unreal_mcp можно использовать бесплатно? Какая у него лицензия?
Unreal_mcp распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Unreal_mcp всё ещё поддерживается?
Активно поддерживается. Последний коммит в Unreal_mcp — 19 окт. 2026 г..
Для чего можно использовать Unreal_mcp?
Позволяет AI-ассистенту создавать акторов, размещать источники света и планировать уровень по запросу в чате. Генерировать графы событий Blueprint или макеты виджетов UMG пакетно. Проверять сборку в редакторе с помощью скриншотов и сессий Play-In-Editor, запущенных ассистентом. Совместно использовать один запущенный редактор нескольким MCP-клиентам команды.
Как установить Unreal_mcp?
Скачайте ZIP-архив плагина из предварительного релиза v0.6 на странице Releases Скопируйте папку EngineWire в каталог Plugins вашего проекта: MyGame/Plugins/EngineWire/ Включите Enable Native MCP Server в Project Settings, затем перезапустите редактор Добавьте сервер в Claude Code с помощью capability token: claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"
Где скачать Unreal_mcp?
Исходный код и инструкции по установке — на GitHub: https://github.com/ChiR24/Unreal_mcp

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты