Unreal-MCP

Overview

UnrealMCP bridges Unreal Engine 5 with AI coding assistants like Claude Code, Cursor, and Windsurf via both CLI and MCP protocols. It supports comprehensive control over Unreal assets including materials, blueprints, Niagara VFX, StateTrees, data tables, actors, performance profiling, and more. The server exposes 280+ commands across 13 categories through a C++ plugin running inside the editor, communicating via TCP.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• health_check

  Verify the Unreal Engine bridge is running

  Try:Check if Unreal MCP is runningTry:Verify the bridge connection
• find_assets

  Search assets by class, path, or name

  Try:Find all materials in /Game/MaterialsTry:Search for blueprint assets
• create_blueprint

  Create a new blueprint asset

  Try:Create a new blueprint named BP_MyActor inheriting from ActorTry:Make a blueprint component for player movement
• build_material_graph

  Build a material graph with nodes and connections

  Try:Create a red material with base color nodeTry:Build a complex material with PBR nodes
• get_data_table_rows

  Retrieve rows from a data table

  Try:Get all rows from /Game/Data/DT_ItemsTry:Show the copper ore entry from items table
• spawn_actor

  Spawn an actor in the level

  Try:Spawn a cube at position [0,0,100]Try:Create a light actor at the player location
• performance_start_trace

  Start performance profiling trace

  Try:Begin profiling with CPU and GPUTry:Start performance capture for frame analysis
• create_input_action

  Create a new enhanced input action

  Try:Create a jump action with boolean valueTry:Make a movement action with vector2D
• create_niagara_system

  Create a new Niagara VFX system

  Try:Create a spark system from the sparks templateTry:Make a new Niagara system for fire effects
• create_statetree

  Create a new StateTree asset

  Try:Create an enemy AI StateTreeTry:Make a patrol behavior StateTree
• get_widget_tree

  Retrieve widget blueprint tree structure

  Try:Show the structure of the HUD widgetTry:Get all elements from the main menu UI
• execute_python

  Execute Python code in the editor

  Try:Print all loaded actorsTry:Get the current world time

Comparable tools

Installation

# Install CLI tool
npm install -g unrealcli

# Setup in UE5 project
cd YourProject/
ue-cli init
ue-cli doctor

# Clone plugin to project
git clone https://github.com/aadeshrao123/Unreal-MCP.git Plugins/UnrealMCP

# Install Python server
pip install unrealmcp

# Add to Claude Desktop config (example)
{
  "mcpServers": {
    "unreal": {
      "command": "unrealmcp"
    }
  }
}

FAQ

Does this support Unreal Engine 4?

Currently supports Unreal Engine 5 (tested on 5.7, may work on earlier 5.x versions).

Can I use this with AI tools that don't support MCP?

Yes, it offers a CLI mode that works with tools like Claude Code through bash tools.

Compare Unreal-MCP with