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!
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
# 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)# 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)# 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)| Category | Tools | Description |
|---|---|---|
| World Building | create_town, construct_house, create_tower, create_arch |
Build complex architectural structures and entire settlements |
| Level Design | create_maze, create_obstacle_course, create_pyramid, create_wall |
Design challenging game levels and puzzles |
| Physics & Materials | spawn_physics_blueprint_actor , set_physics_properties |
Create realistic physics simulations |
| Blueprint System | create_blueprint, compile_blueprint, add_component_to_blueprint |
Visual scripting and custom actor creation |
| Actor Management | spawn_actor, delete_actor, set_actor_transform, find_actors_by_name |
Precise control over scene objects |
- Unreal Engine 5.5+
- Python 3.12+
- MCP Client (Claude Desktop, Cursor, or Windsurf)
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 EditorOption 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" → Enablecd Python
uv run unreal_mcp_server_advanced.pyAdd 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"
]
}
}
}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
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
> "Create a medieval castle with towers and walls"
> "Build a physics playground with bouncing balls"
> "Generate a town square with fountain and buildings"
> "Make a challenging maze for players to solve"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]
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
- Multi-AI Building: Set up multiple AI agents to build different districts of a city simultaneously
- Physics Playgrounds: Create interactive environments with realistic object behavior
- Procedural Content: Generate mazes, buildings, and landscapes through AI prompts
- Rapid Prototyping: Test game mechanics and level designs through natural language
AI-First Design: Every tool designed specifically for natural language control by AI agents
Real-Time Feedback: Immediate visual results in Unreal Editor as you build
Scalable: From single objects to complete environments - no limits on complexity
Game-Engine Native: Full access to Unreal's rendering, physics, and material systems
Extensible: Add your own tools and extend functionality through the modular architecture
Join our community and get help building amazing worlds!
- 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
- 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
MIT License - Build amazing things freely.