Claude Unreal — AI Agent MCP Server

Control Unreal Engine 5 through natural language. Claude Unreal connects Claude Code to your Editor via MCP — 17 typed MCP tools (13 hot-path actions + discovery + helper) with the full ~435-command long tail available via a bundled `cu` CLI. Designed to keep session-start context minimal while preserving full UE5 control across 20 categories.

🌐 Official website: https://echoulen.github.io/claude-unreal/

📖 Docs & full tool reference: https://echoulen.github.io/claude-unreal/docs/

🐛 Support, bug reports & feature requests: https://github.com/yO-oa/claude-unreal-support/issues

## Videos

- Claude Unreal #1 — AI Agent Fully Automates Blueprint Editing in UE5: https://youtu.be/ktWlLYWJQks

- Claude Unreal #2 — AI Agent Places Actors in UE5 from Natural Language: https://youtu.be/WgFBCEFLkQk

- Claude Unreal #3 — AI Agent Builds Enhanced Input Controls in UE5: https://youtu.be/C_8y6O_4lHs

## Examples

- "Build a Behavior Tree that patrols between the 3 selected Target Points."

- "Spawn a 200cm blue sphere, attach a PointLight, screenshot."

- "Generate a 4km landscape from this heightmap, paint grass below 30°."

## Tool Categories

- Scene & Actors — spawn, move, attach, query

- Assets — search, import, rename, tag

- Blueprints — classes, components, node graphs

- UMG Widgets — buttons, text, events, animation

- Materials — graphs, instances, parameters

- Animation — blueprints, state machines, montages, retargeting

- Sequencer — tracks, keyframes, playback

- Landscape & Foliage — sculpt, paint, spawners

- Physics — collision, constraints, forces

- Mesh — LODs, Nanite, sockets

- World Partition — layers, grids, HLODs

- AI Systems — BT, blackboards, nav, EQS

- Niagara VFX — emitters, modules, renderers

- Audio — components, MetaSounds, mixes

- Input — actions, contexts, triggers

- Build & Packaging — lighting, tests, cooking

- Game Simulation — PIE, screenshots, logs

- PCG — graphs, nodes, volumes, user parameters (requires Unreal's built-in PCG plugin to be enabled)

- Camera — focal length, aperture, focus distance

- Meta — batch helpers (`batch_execute` to coalesce many calls per round-trip)

Full tool-by-tool list on the documentation site.

## Usage

- Embedded: Tools → Claude Code Terminal (live context bar inside the editor)

- Your own terminal: run `claude` in the project — plugin auto-configures `.mcp.json`

## Installation

1. Install from Fab, enable in Edit → Plugins

2. Install `uv` — https://docs.astral.sh/uv/

3. Restart Editor — `.mcp.json` and Python deps auto-install

## Requirements

- Unreal Engine 5.7+ (macOS / Windows 64)

- `uv` 0.4+

- Claude Code CLI + Anthropic account (not included; bring your own)