Unreal Engine MCP インスタンスの中央管理プラットフォーム — AI エージェントと UE の間の橋渡しをフル開発ライフサイクル全体で行います。

RemoteMCP(MCPプロトコルを介してエンジン機能を公開するUE Editorプラグイン)で動作します。 Hub は、プラグインをインストールし、コンパイルし、エディタを起動し、クラッシュを検出し、すべてのツールコールを透明にプロキシします。そのため、AI エージェントは 1 つの MCP エンドポイントのみを必要とします。

RemoteMCP は、inside UE Editor を実行し、6 ドメイン(レベル、青写真、umg、edgraph、振る舞い、slate) を渡る 17 + ツールを提供します。 UnrealMCPHub は、** UE Editor を実行し、UE が実行されていない場合でも、コンパイル、起動、モニター、プロキシを実行できます。

##特徴

• プロジェクト設定 — [.uproject]を一度設定します。 レジストリから自動検出されたエンジン
• ビルド&起動 — UBT経由のコンパイル、起動エディタ、MCPの対応待ち -Plugin install — RemoteMCP のインストールをワンクリック (ローカルコピーまたは GitHub ダウンロード)
• Instance Discovery — UE エディタを実行するためのスキャンポート
• ue_run_python, [ue_call], [ue_list_tools], ドメインディスパッチ
• クラッシュレジリエンス — クラッシュ検出、レポート検索、再起動フロー

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

Option A: One-line install from PyPI (recommended)

# 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"]
    }
  }
}

Option D: Clone for development

git clone https://github.com/blackplume233/UnrealMCPHub.git
cd UnrealMCPHub