Home

Home

Welcome to the Unreal Engine MCP Server documentation!

---

What is Unreal MCP?

Unreal MCP lets you control Unreal Engine using natural language through AI assistants like Claude, Cursor, and Windsurf.

Version	0.5.18
Unreal Engine	5.0 - 5.7
Platforms	Win64, Mac, Linux
License	MIT (Free)

---

Key Features

Category	What You Can Do
Assets	Import, create, duplicate, rename, delete
Actors	Spawn, move, rotate, scale, add components
Blueprints	Create, edit graphs, add variables/functions
Levels	Load, save, create, manage streaming
Animation	Animation BPs, Control Rig, Blend Spaces
Effects	Niagara particles, GPU simulations
AI	Behavior Trees, EQS, State Trees
Audio	Sound cues, MetaSounds
Gameplay	GAS, Character, Combat, Inventory

36 tools with 200+ actions available.

---

Get Started in 5 Minutes

Step 1: Copy plugin to your project

Unreal_mcp/plugins/McpAutomationBridge/ → YourProject/Plugins/

Step 2: Enable plugin in Unreal Editor

Step 3: Add this to your AI client config:

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

Done! The MCP server runs automatically. No installation needed.

---

Documentation

Page	Description
Quick Start	Get started in 5 minutes
Installation	Complete setup guide
Tools Reference	All 36 tools documented
Configuration	Environment variables
FAQ	Common questions
Troubleshooting	Solve issues

---

How It Works

┌─────────────┐     WebSocket      ┌──────────────┐
│  AI Client  │◄──────────────────►│  UE Plugin   │
│  (Claude)   │     Port 8091      │  (C++ Native)│
└─────────────┘                    └──────────────┘

1. You ask your AI to do something in Unreal
2. AI sends the request to MCP server
3. MCP server communicates with UE plugin
4. Plugin executes in Unreal Editor
5. Result returns to your AI

---

Links

Resource	URL
GitHub Repo	https://github.com/ChiR24/Unreal_mcp
NPM Package	https://www.npmjs.com/package/unreal-engine-mcp-server
Issues	https://github.com/ChiR24/Unreal_mcp/issues
Discussions	https://github.com/ChiR24/Unreal_mcp/discussions