Installation

Installation Guide

Complete setup guide for Unreal Engine MCP Server.

---

Prerequisites

Requirement	Details
Node.js	18+ (LTS recommended) - Download
Unreal Engine	5.0 - 5.7
AI Client	Claude Desktop, Cursor, Windsurf, or any MCP client

---

Quick Setup (Recommended)

Step 1: Get the Plugin

Clone or download the repository:

git clone https://github.com/ChiR24/Unreal_mcp.git

Or download ZIP from: https://github.com/ChiR24/Unreal_mcp

Step 2: Copy Plugin

From: Unreal_mcp/plugins/McpAutomationBridge/
To:   YourProject/Plugins/McpAutomationBridge/

Step 3: Enable Plugin

1. Open your project in Unreal Editor
2. Go to Edit → Plugins
3. Search "MCP Automation Bridge"
4. Enable it
5. Restart Editor

Step 4: Configure AI Client

Add this to your MCP config file:

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "C:/Path/To/YourProject"
      }
    }
  }
}

That's it! The MCP server will download and run automatically when you start your AI client.

---

MCP Config File Locations

AI Client	Config File Location
Claude Desktop (Windows)	%APPDATA%/Claude/claude_desktop_config.json
Claude Desktop (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.config/windsurf/mcp.json

---

Required Plugins

Enable these in Edit → Plugins:

Plugin	Required
MCP Automation Bridge	Yes
Editor Scripting Utilities	Yes
Niagara	Yes

---

Optional Plugins

These are auto-enabled when needed:

Plugin	Used By
Level Sequence Editor	manage_sequence
Control Rig	animation_physics
GeometryScripting	manage_geometry
Behavior Tree Editor	manage_behavior_tree
Gameplay Abilities	manage_gas
MetaSound	manage_audio
StateTree	manage_ai
Enhanced Input	manage_input
Smart Objects	AI systems
Chaos Cloth	Cloth simulation
Interchange	Asset import/export
OnlineSubsystem	Networking/sessions

---

Full MCP Config Example

All available settings (most are optional):

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "C:/Projects/MyGame",
        "MCP_AUTOMATION_PORT": "8091",
        "LOG_LEVEL": "info",
        "WASM_ENABLED": "true"
      }
    }
  }
}

Settings Explained

Setting	Required	Default	Description
UE_PROJECT_PATH	Yes	-	Path to your Unreal project folder
MCP_AUTOMATION_PORT	No	8091	WebSocket port (change if port conflict)
LOG_LEVEL	No	info	Logging: debug, info, warn, error
WASM_ENABLED	No	true	WebAssembly acceleration

---

Running from Source (Optional)

If you want to modify the code:

git clone https://github.com/ChiR24/Unreal_mcp.git
cd Unreal_mcp
npm install
npm run build

Then use this config:

{
  "mcpServers": {
    "unreal-engine": {
      "command": "node",
      "args": ["X:/GitHub/Unreal_mcp/dist/cli.js"],
      "env": {
        "UE_PROJECT_PATH": "C:/Projects/MyGame"
      }
    }
  }
}

---

Verification

1. Open your Unreal project
2. Start your AI client
3. Ask: "List assets in /Game"

Expected: A list of your project's assets.

---

Need Help?

• Quick Start - 5-minute setup
• Configuration - All settings
• Troubleshooting - Common issues