ue5-toolkit
Targets UE5 C++ projects: discovers the .uproject descriptor and *.Target.cs targets, builds a target via Unreal Build Tool with diagnostics and full process logs, runs named Unreal Automation test suites/filters and interprets the exported JSON report, and triages engine/project logs (MSVC, Clang, UE diagnostics) with source locations. Engine execution is opt-in and can be pointed at a local UE 5.x install.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Claude Code Unreal Toolkit
A local MCP server, two project hooks, and three Claude Code skills for UE5 C++ development. Build a discovered target, run a named Unreal Automation suite, and return diagnostics with source locations and paths to the full logs.
Try it without Unreal Engine
Requires Python 3.11 or newer. The demo starts the same stdio MCP server configured for Claude Code, creates a temporary project with a sample Clang diagnostic, and calls project_info and analyze_log.
git clone https://github.com/romaktion/claude-code-unreal-toolkit.git
cd claude-code-unreal-toolkit
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
python examples/demo.py
python -m pytest -qUse any supported Python to create the environment. On Windows PowerShell, use py -3.12 -m venv .venv and & .\.venv\Scripts\Activate.ps1.
Project: Demo.uproject | targets: DemoEditor
error: Source/Demo/Player.cpp:27: use of undeclared identifier 'AmmoCount'Related MCP server: UEMCP
Connect Claude Code to a UE5 project
Install the toolkit in a virtual environment as above. From the UE project directory, activate that same environment so both MCP and the hooks resolve
python.Copy
.mcp.jsonand the.claudesettings and skills into the UE project root. If those files already exist, merge theue5-toolkitserver and hook entries into the existing JSON and add the skill folders.Launch
claudein that root and approve the project MCP server when prompted. Check/mcporclaude mcp listfor its status.Start with “Call
project_info” or/ue5-debug Saved/Logs/MyGame.log. Engine execution is off by default. To opt in, set the variables below before starting Claude Code.
export UE_ENGINE_ROOT="/path/to/UE_5.x" # Directory containing Engine/
export UE_TOOLKIT_ENABLE_RUNS=1
claudeIn PowerShell, use $env:UE_ENGINE_ROOT = "C:\path\to\UE_5.x" and $env:UE_TOOLKIT_ENABLE_RUNS = "1". The workspace should have one top-level .uproject. Set UE_PROJECT_FILE to a workspace-relative path when there are multiple descriptors or the project is nested.
MCP tool | Example arguments | Result |
|
| Descriptor, discovered |
|
| Native UBT result, diagnostics, and process log |
|
| Outcome based on UE's JSON report, with counts and test names |
|
| Deduplicated MSVC, Clang, and UE diagnostics from the last 1 MiB |
Use /ue5-build [target] [configuration] to build, /ue5-debug [log path] to triage, and /ue5-code-review [paths or revision range] to review UE C++. To run automation, ask Claude Code to call run_automation_tests with one dotted test name, suite prefix, or Group:Name. Build first so the editor loads the current test code.
The pre-tool hook blocks direct edits to binary assets and generated paths, plus common destructive Bash commands such as rm -rf and git reset --hard. The post-tool hook gives an advisory when a reflected C++ header appears to be missing its own .generated.h include or places another include after it.
Run the included UE5 C++ example
With UE5 and its native C++ toolchain installed, run this from the toolkit checkout:
UE_ENGINE_ROOT="/path/to/UE_5.x" python examples/demo.py --engineThe script opens a real MCP session, builds ToolkitSmokeEditor, runs ToolkitSmoke.Math.ClampAmmo, checks the exported report, and verifies that an unmatched filter never reports success. The sample contains just an editor target, a runtime module, and one automation test. It uses the engine's built-in Entry map.
Verified on macOS arm64 with UE 5.8.4: UBT returned success; the exported report showed one test passed, zero failed. The engine-free tests cover stdio tool discovery, diagnostics, report interpretation, timeout handling, path restrictions and the hook input/output format. CI exercises these tests without installing Unreal on Linux, macOS and Windows. Real engine execution on Windows and Linux has not been verified.
Boundaries
Engine operations run locally under your account. Use trusted engine and project code; build rules and project modules execute code. Hooks catch a subset of common mistakes and do not sandbox shell commands.
Builds target the native host. The automation launcher uses NullRHI and is meant for tests that can run without rendering. Each server allows one engine job at a time.
Full process logs and automation reports stay under
Saved/ClaudeUnrealToolkit/in the UE project. Review logs before sharing them. A missing or incomplete automation report cannot turn a zero editor exit code into a pass.Diagnostic output is bounded; check the full log if the root cause is earlier. Generated include hints do not parse preprocessor branches or replace UHT. Windows build paths with CMD metacharacters such as
%or!are rejected.
References: Claude Code hooks, MCP configuration, Claude Code skills, MCP Python SDK 1.x, and Unreal Automation command line.
Developed with AI coding assistance. Licensed under MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Build, test and cache insights for Xcode, Gradle and Bazel projects, for coding agents.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Build, validate, test-run and publish AIOS workflows from Claude Code, Codex, Cursor or VS Code.
1Discover software problems, analyze evidence, and create implementation-ready Build plans.
Related MCP Servers
- AlicenseAqualityFmaintenanceProvides build diagnostics and editor log tools for Unreal Engine AI development, enabling Live Coding builds, parsing compile errors, searching/filtering logs, and crash context.11MIT
- AlicenseBqualityCmaintenanceEnables Claude to control Unreal Engine 5 editor, spawn actors, build materials, author Blueprints, and more, with zero plugin installation.31312 PyPIMIT
- FlicenseAqualityDmaintenanceBridges Claude AI to a live Unreal Engine 5 editor session, enabling natural language control of scene inspection, modification, logging, source search, console commands, and C++ class scaffolding.10-
- AlicenseAqualityDmaintenanceEnables Claude to control a running Unreal Engine editor via Epic's Python Remote Execution protocol, supporting asset import, actor manipulation, viewport screenshots, and arbitrary Python execution.11MIT