Unreal Engine MCP

MCP tool that enables natural language control of Unreal Engine 5.6+. Designed for large-scale projects with specialized Blueprint workflow support. Build node graphs, create GameplayAbilities, and automate editor tasks through MCP client. Includes RAG-powered Python scripting with Unreal Python API documentation.

🎬 Demo

Homing Cluster Grenade - Lyra grenade + MCP-generated Blueprints (GA, skill system)

⭐ Features

📐 Architecture

┌─────────────────────────────────────────────────────────────┐
│              Claude Desktop / Cursor (Client)                │
│            LLM reasoning & tool invocation                   │
└──────────────────────────┬──────────────────────────────────┘
                           │ MCP Protocol (stdio)
┌──────────────────────────┴──────────────────────────────────┐
│                    Python MCP Server                         │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ Tools                                                  │ │
│  │  • editor_tool    - Actor/asset manipulation           │ │
│  │  • blueprint_tool - Blueprint/GAS node graphs          │ │
│  │  • pcg_tool       - PCG graph construction             │ │
│  │  • rag_tool       - API search & Python execution      │ │
│  └────────────────────────────────────────────────────────┘ │
└──────────────────────────┬──────────────────────────────────┘
                           │ TCP
┌──────────────────────────┴──────────────────────────────────┐
│                 Unreal Engine C++ Plugin                     │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ Command Handlers                                       │ │
│  │  • EditorCommands    - Level actor operations          │ │
│  │  • BlueprintCommands - BP asset & node graph editing   │ │
│  │  • PCGCommands       - PCG graph manipulation          │ │
│  │  • PythonExecutor    - Python script execution         │ │
│  └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

RAG System (BM25):
  • Provides Unreal Python API documentation search
  • Used by execute_unreal_python on failure for error recovery
  • No external API keys required

📖 Start Guide

Requirements

Note: uv package manager is recommended but will be installed automatically if not present.

1. Clone Repository

git clone https://github.com/gimmeDG/UnrealEngine5-mcp.git
cd UnrealEngine5-mcp

2. Setup Unreal Engine Plugin

1. Copy Plugins/UnrealEngineMCP folder to your Unreal project’s Plugins/ directory
2. Open your project in Unreal Editor
3. Enable the plugin: Edit → Plugins → Search “UnrealEngineMCP” → Enable
4. Restart Unreal Editor

3. Configure MCP Client

Claude Desktop

Windows - Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "UnrealEngineMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\unreal-engine-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

macOS - Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "UnrealEngineMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unreal-engine-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Cursor

Settings → MCP → Add Server with the same configuration:

{
  "UnrealEngineMCP": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/unreal-engine-mcp",
      "run",
      "main.py"
    ]
  }
}

4. (Optional) Environment Setup

cp .env.example .env
# Edit .env if you need to change default settings

Default configuration works out of the box. The server will:

• Automatically create virtual environment
• Install all dependencies
• Generate BM25 index on first run

🛠️ Available Tools

Editor Tools (21 tools)

Blueprint Tools (47 tools)

RAG Tools (2 tools)

PCG Tools (13 tools) - Early Stage

In Development: PCG tools are functional but still being refined.

📄 License

MIT License

💬 Feedback

Found a bug or have a suggestion? Open an issue.