BU

blackplume233/unrealmcphub

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

28 stars 5 forks Качество 59 Тренд 11

Автономный MCP Hub для управления жизненным циклом разработки Unreal Engine - сборка, запуск, мониторинг и прокси UE MCP экземпляров

Обзор

Центральная платформа управления для экземпляров Unreal Engine MCP — мост между агентами ИИ и UE на протяжении всего жизненного цикла разработки. Работает с (плагином редактора UE, который раскрывает возможности двигателя через протокол MCP). Хаб управляет всем вокруг: устанавливает плагин, компилирует, запускает редактор, обнаруживает сбои и прозрачно прокси-сервер всех вызовов инструментов — поэтому агенту ИИ нужна только одна конечная точка MCP. Запускает редактор UE и предоставляет 17+ инструментов по 6 доменам (уровень, чертеж, umg, эдграф, бихевиотри, шифер). Запускает редактор UE и может компилировать, запускать, контролировать и прокси-серверы, даже если UE не работает. - Настройка.

Обзор (машинный перевод)

Центральная платформа управления для экземпляров Unreal Engine MCP — мост между агентами ИИ и UE на протяжении всего жизненного цикла разработки.

Работает с RemoteMCP (плагин редактора UE, который раскрывает возможности двигателя через протокол MCP). Хаб управляет всем вокруг: устанавливает плагин, компилирует, запускает редактор, обнаруживает сбои и прозрачно прокси-сервер всех вызовов инструментов — поэтому агенту ИИ нужна только одна конечная точка MCP.

RemoteMCP запускает inside UE Editor и предоставляет 17+ инструментов по 6 доменам (уровень, чертеж, umg, эдграф, бихевиодер, шифер). UnrealMCPHub** работает вне редактора UE и может компилировать, запускать, контролировать и прокси-сервер, даже если UE не работает.

Особенности

Настройка проекта — конфигурация .uproject один раз; двигатель автоматически обнаруживается из реестра Build & Launch — Компиляция через UBT, редактор запуска, ожидание готовности MCP Установка плагина — установка RemoteMCP одним щелчком мыши (локальная копия или загрузка GitHub) Открытие информации — порты сканирования для поиска работающих редакторов UE ** Инструмент UE proxy** — ue_run_python, ue_call, ue_list_tools и отправка домена Устойчивость к аварии - Обнаружение аварий, поиск отчетов, перезапуск потока

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

UnrealMCPHub

Central management platform for Unreal Engine MCP instances — bridge between AI agents and UE across the full development lifecycle.

Works with RemoteMCP (UE Editor plugin that exposes engine capabilities via MCP protocol). The Hub manages everything around it: install the plugin, compile, launch the editor, detect crashes, and transparently proxy all tool calls — so the AI agent only needs one MCP endpoint.

AI Agent ──► UnrealMCPHub ──► UE Editor + RemoteMCP plugin
              (this repo)       (blackplume233/UnrealRemoteMCP)

RemoteMCP runs inside UE Editor and provides 17+ tools across 6 domains (level, blueprint, umg, edgraph, behaviortree, slate). UnrealMCPHub runs outside UE Editor and can compile, launch, monitor, and proxy — even when UE is not running.

Features

  • Project setup — Configure .uproject once; engine auto-detected from registry
  • Build & launch — Compile via UBT, launch editor, wait for MCP readiness
  • Plugin install — One-click RemoteMCP installation (local copy or GitHub download)
  • Instance discovery — Scan ports to find running UE editors
  • UE tool proxy — ue_run_python, ue_call, ue_list_tools and domain dispatch
  • Crash resilience — Crash detection, report retrieval, restart flow
  • Multi-instance — Switch between multiple UE editors via use_editor
  • Session notes — Persist context for crash recovery
  • One-click overview — hub_status shows project, plugin, instances, and watcher state

Quick Install

# uv (recommended)
uv tool install unrealhub

# or pip
pip install unrealhub

Then add to .cursor/mcp.json:

{
  "mcpServers": {
    "unrealhub": {
      "command": "unrealhub",
      "args": ["serve"]
    }
  }
}

Option B: Zero-install (auto-fetch on first launch)

No download, no clone, no install. Paste this single block into .cursor/mcp.json and restart Cursor:

{
  "mcpServers": {
    "unrealhub": {
      "command": "uvx",
      "args": ["unrealhub", "serve"]
    }
  }
}

Requires uv (pip install uv or winget install astral-sh.uv). Cursor will auto-fetch the Hub on first launch.

Option C: Standalone executable (no Python needed)

Download the latest executable for your platform from GitHub Releases, then:

{
  "mcpServers": {
    "unrealhub": {
      "command": "/path/to/unrealhub",
      "args": ["serve"]
    }
  }
}
Platform File
Windows x64 unrealhub-windows-amd64.exe
macOS ARM unrealhub-macos-arm64
Linux x64 unrealhub-linux-amd64

Option D: Clone for development

git clone https://github.com/blackplume233/UnrealMCPHub.git
cd UnrealMCPHub
Открыть полный README на GitHub

Установка

uvx unrealhub serve
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "unrealhub": { "command": "unrealhub", "args": ["serve"] } } }