unreal-mcp

Level ALocal

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

Overview

unreal-mcp lets AI assistants like Cursor, Windsurf, and Claude Desktop control Unreal Engine through natural language. It covers actor management, Blueprint creation and node graph editing, and editor viewport control, built from a C++ plugin and a Python MCP server. The project is experimental, so APIs may change.

⭐ 2.1kDevelopment ToolsC++Repo ↗Updated 2025-04-22

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "chongdashu-unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/unreal-mcp/Python>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/chongdashu/unreal-mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "chongdashu-unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/unreal-mcp/Python>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers