This repository provides the MCP (Model Context Protocol) server and C++ plugin for Unreal Engine 5.5+, enabling AI clients (Claude, Cursor, Windsurf) to control the engine via natural language. It targets developers and power users aiming to automate complex 3D world creation, architectural design, and Blueprint programming, significantly boosting productivity through AI-driven commands.

How It Works

AI clients communicate via MCP protocol to a Python server (unreal_mcp_server_advanced.py), which uses TCP sockets to connect to a native C++ plugin within Unreal Engine 5.5+. This C++ plugin interfaces directly with Unreal's API, ensuring minimal latency for real-time control and robust communication. It grants comprehensive access to Unreal's actor, component, and Blueprint systems.

Quick Start & Requirements

• Prerequisites: Unreal Engine 5.5+, Python 3.12+, an MCP client (Claude Desktop, Cursor, or Windsurf).
• Installation: Recommended: Clone the repository (git clone https://github.com/flopperam/unreal-engine-mcp.git) and open the .uproject file; the plugin is pre-installed. Alternatives include copying the plugin to a project's Plugins folder or the engine's plugin directory.
• Launch: Run uv run unreal_mcp_server_advanced.py from the Python directory.
• Configuration: Update your MCP client's configuration file with server details.
• Resources: Comprehensive setup tutorials and guides are available.

Highlighted Details

• AI Blueprint Scripting: Enables AI control over Blueprint node creation, graph management, variables, and functions (23+ node types).
• World Building: Facilitates AI-driven creation of towns, castles, mansions, mazes, and large-scale architectural projects.
• Physics & Materials: Allows AI to spawn physics actors, configure properties, and apply materials.
• Project Recommendation: The project highlights "The Flop Agent" (https://flopperam.com/) as a more advanced, autonomous solution with on-demand asset generation, recommending it for the best user experience.

Maintenance & Community

The MCP server is under active development. Community engagement is active via Discord (discord.gg/8yr1RBv), YouTube (youtube.com/@flopperam), Twitter/X (twitter.com/Flopperam), and TikTok (tiktok.com/@flopperam). Support includes a Debugging Guide, Discord assistance, and GitHub Issues.

Licensing & Compatibility

Released under the permissive MIT License, allowing free use, modification, and distribution, including in commercial applications and closed-source projects.

Limitations & Caveats

This MCP server requires Unreal Engine 5.5+. The project strongly recommends "The Flop Agent" (https://flopperam.com/) for a superior, fully autonomous AI experience, suggesting MCP may be a precursor or less capable solution.