Unreal MCP connects AI assistants to the Unreal Editor through the Model Context Protocol. Spawn actors, build Blueprint graphs, construct Behavior Trees, design UMG widgets, edit materials, author cinematics — all from natural language.
253 actions across 21 domains, plus execute_python as an escape hatch — run any BlueprintCallable function or editor subsystem the engine exposes to Python, on the fly.
Unreal Engine MCP Server: Control UE5 with Claude & AI Agents. Supports Python and C++ for custom tool development.
Yıldızlar
146
Araçlar
—
Çalışma süresi
—
Easy to extend. Adding an action is a Python function plus a catalog regen — no C++ and no editor rebuild on the Python path. When you need something Python doesn't expose (e.g. reference-skeleton bones), an optional C++ helper layer is there too. See CLAUDE.md for the step-by-step workflow.
Features
Each row is one namespace tool. The action set is large but the tool list stays small, so it never bloats the model's context. 253 actions across 21 domains.
Domain
Capabilities
Actions
actor
Spawn (class/object/surface raycast), transform get/set, properties, live component properties, hierarchy (attach/detach), folders, tags, bounds, selection, duplication, class queries.
Need something not covered by a built-in action? Use util / execute_python to run any Unreal Python directly — the full engine API is available with no C++ build.
Extending
Adding a tool is intentionally low-friction — anyone comfortable with Python can do it:
Add a ue_<name>(...) function (returning a JSON string) to a domain module in
Plugins/UnrealMCPython/Content/Python/UnrealMCPython/<domain>_actions.py.
Run python generate_catalog.py — the action is now exposed by its domain tool.
(Optional) add an in-editor test in tests/test_<domain>.py.
The Python path needs no C++ and no editor rebuild. New domain? Drop in a
<domain>_actions.py and list it in the generator. For an API that Python doesn't
expose, an optional C++ helper (MCPythonHelper) is available. Full details in
CLAUDE.md.
An MCP client (Claude Desktop, VS Code, Cursor, etc.)
Step 1 — Install the Plugin
Option A: Download from GitHub Releases (Recommended)
Each release ships two kinds of plugin asset. Most users want the precompiled one for their exact engine version:
✅ UnrealMCPython_<engine>_<version>.zip (e.g. UnrealMCPython_5.8_2.2.0.zip) — precompiled for that exact UE version. No C++ toolchain, no rebuild — just drop it in and launch. Pick the one matching your engine version.
🛠️ UnrealMCPython_Source_<version>.zip — source only, for C++ developers (the CI release pipeline runs on Linux and does not compile the C++ module). Unreal tries to compile it on first open, which requires Visual Studio with the "Game development with C++" workload. Without that toolchain the build fails and the editor closes — so don't use this one unless you intend to compile.
Extract, then copy Plugins/UnrealMCPython/ into your project's Plugins/ folder:
Keep the mcp-server/ folder from the zip in a convenient location — you'll need its path in Step 3.
[!NOTE]
Precompiled binaries are engine-version-specific. If there's no _<your engine>_ zip for your version, either ask for one in an issue or use the source zip and let Unreal compile it on first open (Windows: Visual Studio with the "Game development with C++" workload). Maintainers build the per-version binaries locally with tools/build-plugin.ps1 (the CI pipeline can't — GitHub-hosted runners have no Unreal Engine).
[!WARNING]
Seeing 'UnrealMCPython' was designed for build 5.7.0 … load anyway? or a rebuild that fails and closes the editor? You downloaded the source zip (or a binary for a different engine version). Download the UnrealMCPython_<your engine>_<version>.zip that matches your engine instead — it loads without compiling. (Source builds from releases ≤ 2.2.0 also pin an old engine version; this is fixed on main.)
[!NOTE]
The Fab version may lag behind the latest GitHub release. After installing from Fab, you still need the mcp-server/ folder from this repository.
Verify — you should see the 19 Unreal-MCPython domain tools listed in your client
Usage
Just describe what you want in natural language:
"Place 10 trees randomly on the terrain surface"
"Find all static meshes with 'rock' in the name"
"Create M_Ground, add a Constant3Vector for base color, and connect it"
"Explain what the selected Blueprint nodes do"
"Create BP_Door from Actor, add a bool 'IsOpen' variable exposed on spawn"
"Build a Behavior Tree with a Selector root and MoveTo/Wait tasks"
"Create a HUD widget with a health bar and a 'Score: 0' label"
"Make a 6-second level sequence with a CineCamera flying from (0,0,200) to (1200,600,500)"
"Tag all PointLights in the level and move them to a 'Lighting' layer"
Tools Reference
Pass any action below to its domain tool. Use { "action": "list_actions" } on a domain to see each action's parameters and docs.
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Sorular
Unreal nasıl kurulur?
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Unreal için API anahtarı gerekiyor mu?
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Unreal hangi aktarımı kullanıyor?
Unreal yerel olarak stdio üzerinden çalışır.
Unreal en son ne zaman kontrol edildi?
Son kontrol: 2026-10-28. Unreal Engine MCP Server: Control UE5 with Claude & AI Agents. Supports Python and C++ for custom tool development.