MCP tool that enables natural language control of Unreal Engine 5.6+. Designed for large-scale projects with specialized Blueprint workflow support.
概览
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. Homing Cluster Grenade - Lyra grenade + MCP-generated Blueprints (GA, skill system) uv package manager is recommended but will be installed automatically if not present. 1. Copy Plugins/UnrealEngineMCP folder to your Unreal project's Plugins/ directory 2. Open your project in Unreal Editor 3. Enable the plugin: 4. Restart Unreal Editor - Edit %APPDATA%\Claude\claude_desktop_config.json: - Edit ~/Library/Application Support/Claude/claude_desktop_config.json: Default configuration works out of the box.
README
以下为原文 README 节选，完整内容请查看原文。
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
| Category | Description |
|---|---|
| Blueprint Tools | Create blueprints, add components, build node graphs, manage variables, connect pins |
| GAS (Gameplay Ability System) | Create GameplayAbilities, GameplayEffects, AbilityTasks with full graph construction |
| Editor Tools | Spawn actors, create materials, manipulate transforms, search assets |
| RAG Search | Search Unreal Python API docs with BM25 |
| Python Execution | Execute Python code in Unreal with RAG-powered documentation lookup |
| PCG Tools | Create PCG graphs, add nodes, connect edges (Early stage - in development) |
📐 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 │ │安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"UnrealEngineMCP": {
"command": "uv",
"args": [
"--directory",
"C:\\path\\to\\unreal-engine-mcp",
"run",
"main.py"
]
}
}
}