虚幻引擎MCP实例的中央管理平台——连接AI代理与UE的桥梁，贯穿整个开发生命周期。

可与RemoteMCP（UE编辑器插件，通过MCP协议展示引擎功能）配合使用。枢纽管理周围一切：安装插件、编译、启动编辑器、检测崩溃，并透明代理所有工具调用——因此AI代理只需一个MCP端点。

RemoteMCP 运行于内部 UE 编辑器，提供跨6个域（关卡、蓝图、UMG、edgraph、行为树、Slate）的17+工具。 UnrealMCPHub 运行外部 UE编辑器，能够编译、启动、监控和代理——即使 UE 未运行。

特色

• 项目设置 — 配置一次.uproject;引擎自动从注册表检测
• 构建与启动 — 通过UBT编译，启动编辑器，等待MCP准备就绪
• 插件安装 — 一键远程 MCP 安装（本地副本或 GitHub 下载）
• 实例发现 — 扫描端口以查找运行中的UE编辑器
• 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