Model Context Protocol for Unreal Engine

What is Model Context Protocol for Unreal Engine?

An experimental integration that enables AI assistant clients like Cursor, Windsurf, and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP). It consists of a UE plugin (C++ TCP server) and a Python MCP server that expose tools for actor, Blueprint, and editor operations.

How to use Model Context Protocol for Unreal Engine?

You use the provided Unreal sample project or copy the plugin into your own project, enable the plugin, and build it. Then set up the Python server (requires Python 3.12+), and configure your MCP client (e.g., Claude Desktop, Cursor, Windsurf) with a JSON configuration pointing to unreal_mcp_server.py. The server communicates with the plugin over TCP (port 55557).

Key features of Model Context Protocol for Unreal Engine

• Create and manipulate actors (cubes, lights, cameras, etc.)
• Set and query actor transforms and properties
• Create Blueprint classes and add components
• Compile Blueprints and spawn Blueprint actors
• Add nodes to Blueprint graphs and connect them
• Control viewport focus and camera

Use cases of Model Context Protocol for Unreal Engine

• Automate actor level layout using natural language
• Rapidly prototype Blueprint logic through chat commands
• Generate and position lighting in a scene via AI assistant
• Create input mappings for player controls without manual setup

FAQ from Model Context Protocol for Unreal Engine

What are the system requirements?

Unreal Engine 5.5+ and Python 3.12+ are required. An MCP-compatible client (Claude Desktop, Cursor, or Windsurf) is also needed.

How do I configure the MCP client?

Add a JSON entry under mcpServers in your client’s configuration file, specifying uv as the command with arguments pointing to the Python directory and unreal_mcp_server.py. The file location varies: Claude Desktop uses ~/.config/claude-desktop/mcp.json, Cursor uses .cursor/mcp.json in the project root, and Windsurf uses ~/.config/windsurf/mcp.json.

Is this production‑ready?

No, the project is currently experimental. Features may be incomplete or unstable, breaking changes can occur without notice, and production use is not recommended.

What transport does the Python server use?

The Python server uses TCP sockets (port 55557) to communicate with the Unreal Engine C++ plugin, and implements the Model Context Protocol via the FastMCP library.

Where can I ask questions or report issues?

You can reach the author on X/Twitter: @chongdashu.