The Most Advanced MCP Server for Unreal Engine

Control Unreal Engine 5.5+ through AI with natural language. Build incredible 3D worlds and architectural masterpieces using MCP. Create entire towns, medieval castles, modern mansions, challenging mazes, and complex structures with AI-powered commands.

Active Development: This project is under very active development with consistent updates, new features, and improvements being added regularly. Join our Discord to stay updated on the latest releases!

🎬 See It In Action

Watch our comprehensive tutorial for complete setup and usage:

• Complete MCP Tutorial & Installation Guide - Full walkthrough of installation, setup, and advanced usage

Check out these examples of the MCP server in action on our channel:

• GPT-5 vs Claude - Watch Claude and GPT-5 go head-to-head building simultaneously - Claude creates a massive fortress while GPT-5 builds a sprawling city
• Advanced Metropolis Generation - Watch AI generate a full-blown metropolis with towers, streets, parks, and over 4,000 objects from a single prompt
• Advanced Maze & Mansion Generation - Watch Claude generate a playable maze and complete mansion complex with wings, towers, and arches

Featured Capabilities

# Create a massive futuristic city with skyscrapers, flying cars, and advanced infrastructure
> "Build a massive futuristic city with towering skyscrapers"
→ create_town(town_size="massive", architectural_style="futuristic", building_density=0.95, include_advanced_features=true)

Advanced Structures

# Build complex multi-room houses with windows, doors, and roofs
> "Create a Victorian mansion complex with east and west wing houses."
→ construct_house(house_style="mansion", width=1500, height=900)

Intelligent Mazes

# Generate solvable mazes with guaranteed paths using recursive backtracking
> "Make a 15x15 maze with high walls"
→ create_maze(rows=15, cols=15, wall_height=4, cell_size=250)

---

Complete Tool Arsenal

Category	Tools	Description
World Building	create_town, construct_house, construct_mansion, create_tower, create_arch, create_staircase	Build complex architectural structures and entire settlements
Epic Structures	create_castle_fortress, create_suspension_bridge, create_aqueduct	Massive engineering marvels and medieval fortresses
Level Design	create_maze, create_pyramid, create_wall	Design challenging game levels and puzzles
Physics & Materials	spawn_physics_blueprint_actor, set_physics_properties, get_available_materials, apply_material_to_actor, apply_material_to_blueprint, set_mesh_material_color	Create realistic physics simulations and material systems
Blueprint System	create_blueprint, compile_blueprint, add_component_to_blueprint, set_static_mesh_properties	Visual scripting and custom actor creation
Actor Management	get_actors_in_level, find_actors_by_name, delete_actor, set_actor_transform, get_actor_material_info	Precise control over scene objects and inspection

---

⚡ Lightning-Fast Setup

Prerequisites

• Unreal Engine 5.5+
• Python 3.12+
• MCP Client (Claude Desktop, Cursor, or Windsurf)

1. Setup Options

Option A: Use the Pre-Built Project (Recommended for Quick Start)

# Clone the repository
git clone https://github.com/flopperam/unreal-engine-mcp.git
cd unreal-engine-mcp

# Open the pre-configured project
# Double-click FlopperamUnrealMCP/FlopperamUnrealMCP.uproject
# or open it through Unreal Engine launcher

# The plugin is already installed and enabled!

Option B: Add Plugin to Your Existing Project

# Copy the plugin to your project
cp -r UnrealMCP/ YourProject/Plugins/

# Enable in Unreal Editor
Edit → Plugins → Search "UnrealMCP" → Enable → Restart Editor

Option C: Install for All Projects

# Copy to Engine plugins folder (available to all projects)
cp -r UnrealMCP/ "C:/Program Files/Epic Games/UE_5.5/Engine/Plugins/"

# Enable in any project through the Plugin Browser
Edit → Plugins → Search "UnrealMCP" → Enable

2. Launch the MCP Server

cd Python
uv run unreal_mcp_server_advanced.py

3. Configure Your AI Client

Add this to your MCP configuration:

Cursor: .cursor/mcp.json Claude Desktop: ~/.config/claude-desktop/mcp.json Windsurf: ~/.config/windsurf/mcp.json

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unreal-engine-mcp/Python",
        "run",
        "unreal_mcp_server_advanced.py"
      ]
    }
  }
}

⚠️ Having issues with setup? Check our Debugging & Troubleshooting Guide for solutions to common problems like MCP installation errors and configuration issues.

Recommended AI Model

We strongly recommend using Claude for the best experience.

Claude has proven to be the most effective AI model for:

• Understanding complex 3D spatial relationships
• Generating accurate MCP tool calls
• Following architectural and physics constraints
• Creating coherent multi-step building processes

Enhanced Accuracy with Rules

For improved results, especially when creating specific types of objects, provide the AI with our curated rules:

• .cursor/rules/ - Contains specialized guides for different creation tasks

4. Start Building!

> "Create a medieval castle with towers and walls"
> "Generate a town square with fountain and buildings"
> "Make a challenging maze for players to solve"

---

Architecture

graph TB
    A[AI Client<br/>Cursor/Claude/Windsurf] -->|MCP Protocol| B[Python Server<br/>unreal_mcp_server_advanced.py]
    B -->|TCP Socket| C[C++ Plugin<br/>UnrealMCP]
    C -->|Native API| D[Unreal Engine 5.5+<br/>Editor & Runtime]
    
    B --> E[Advanced Tools]
    E --> F[World Building]
    E --> G[Physics Simulation]  
    E --> H[Blueprint System]
    
    C --> I[Actor Management]
    C --> J[Component System]
    C --> K[Material System]

Loading

Performance: Native C++ plugin ensures minimal latency for real-time control Reliability: Robust TCP communication with automatic reconnection Flexibility: Full access to Unreal's actor, component, and Blueprint systems

---

Community & Support

Join our community and get help building amazing worlds!

Connect With Us

• YouTube: youtube.com/@flopperam - Tutorials, showcases, and development updates
• Discord: discord.gg/8yr1RBv - Get help, share creations, and discuss the plugin
• Twitter/X: twitter.com/Flopperam - Latest news and quick updates
• TikTok: tiktok.com/@flopperam - Quick tips and amazing builds

Get Help & Share

• Setup Issues? Check our Debugging & Troubleshooting Guide first
• Questions? Ask in our Discord server for real-time support
• Bug reports? Open an issue on GitHub with reproduction steps
• Feature ideas? Join the discussion in our community channels

---

License

MIT License - Build amazing things freely.