This project enables AI assistants like Cursor, Windsurf, and Claude Desktop to control Unreal Engine via natural language commands using the Model Context Protocol (MCP). It offers comprehensive capabilities for actor management, Blueprint development, node graph manipulation, and editor control, aiming to streamline complex Unreal Engine workflows for developers and designers.

How It Works

The integration consists of a C++ Unreal Engine plugin and a Python server. The C++ plugin acts as a native TCP server within the Unreal Editor, handling command execution and response management. The Python server establishes a TCP connection to the C++ plugin, serializes commands, and manages tool modules for specific Unreal Engine operations, all orchestrated through the Model Context Protocol.

Quick Start & Requirements

• Install/Run: Copy the plugin to your project, enable it in Unreal Engine, build the plugin, and run the Python server (Python/unreal_mcp_server.py).
• Prerequisites: Unreal Engine 5.5+, Python 3.12+.
• Setup: Requires building the C++ plugin and configuring your MCP client with the provided JSON.
• Docs: Docs/README.md

Highlighted Details

• Supports actor creation, transformation, and querying.
• Enables Blueprint class creation, component configuration, and compilation.
• Allows manipulation of Blueprint node graphs, including adding nodes, variables, and connecting logic.
• Provides editor control for viewport focus and camera manipulation.

Maintenance & Community

The project is maintained by chongdashu, with contact available via X/Twitter: @chongdashu.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive for commercial use and closed-source linking.

Limitations & Caveats

The project is explicitly marked as EXPERIMENTAL, with potential for breaking changes, incomplete features, and outdated documentation. Production use is not recommended at this time.