MCP.so
Sign In

Model Context Protocol for Unreal Engine

@chongdashu

Repository

About Model Context Protocol for Unreal Engine

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

#unreal-engine-5#mcp-server#modelcontextprotocol

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/the/folder/PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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](https://www.x.com/chongdashu).

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

chongdashu

More AI & Agents MCP servers

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.

Sphere

dtajitdinov-aris

Open marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.

Competitor Tracker & Co.

Competitor Tracker & Co.

Competitor Tracker & Co. watches your competitors' websites and tells you what changed. Every week it crawls their pricing, product, messaging and corporate pages, detects the changes that matter, and files a tagged, ran

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14