unreal-master-mcp-server

MCP server that gives Claude AI bidirectional control over Unreal Engine — 188 tools across 37 domains for Blueprints, materials, actors, levels, sequencer, AI, and more.

Quick Start

1. Configure Claude Desktop or Claude Code

Add to your MCP config (.claude/mcp.json or claude_desktop_config.json):

{
  "mcpServers": {
    "unreal-master": {
      "command": "npx",
      "args": ["-y", "unreal-master-mcp-server"],
      "env": {
        "UE_WS_PORT": "9877"
      }
    }
  }
}

2. Install the UE Plugin

Download the plugin from GitHub Releases and copy it to your project's Plugins/ directory, or use the install script:

git clone https://github.com/jaguarcode/UnrealMasterAI.git
./UnrealMasterAI/scripts/install-plugin.sh /path/to/YourProject

3. Start Using

Open your UE project (the plugin auto-connects), then ask Claude:

"Add a PrintString node to BP_TestActor connected after BeginPlay, set the message to 'Hello World', then compile."

Interactive Setup Wizard

npx unreal-master-mcp-server init

Generates the MCP config snippet, validates Node.js version, and detects your UE project.

What You Can Do

| Domain | Tools | Examples | |--------|-------|---------| | Blueprint | 5 | Serialize to JSON AST, create nodes, connect pins, modify properties | | Actor | 9 | Spawn, delete, transform, properties, components | | Material | 6 | Create, set parameters, textures, instances | | Level | 5 | Create, open, save, sublevels, world settings | | Asset | 8 | Import, export, create, duplicate, rename, delete | | Animation | 5 | Montages, blend spaces, sequences, skeleton info | | Sequencer | 8 | Create cinematics, tracks, bindings, keyframes, FBX | | AI/Navigation | 8 | Behavior trees, blackboards, nav mesh, EQS | | Widget/UMG | 6 | Create widgets, elements, properties, bindings | | Niagara VFX | 6 | Particle systems, emitters, parameters | | Landscape | 5 | Create terrain, heightmaps, materials | | Physics | 5 | Physics assets, profiles, constraints, materials | | Workflow | 8 | Character setup, UI screens, multiplayer, inventory | | Context | 15 | Intent matching, workflow learning, error recovery | | + 23 more | ... | Texture, audio, PCG, foliage, curves, debug, build... |

Full API Reference (188 tools)

Architecture

Claude Code / Claude Desktop
    | stdio / JSON-RPC
MCP Bridge Server (this package)
    | WebSocket (port 9877)
UE Agent Plugin (C++)
    | Direct C++ / Python API calls
Unreal Engine 5.4-5.7

• UE is the WebSocket client — this server listens, UE connects
• All UE operations run on GameThread — safe async dispatch
• Self-healing compilation — parse errors, apply fix, retry (max 3)
• Safety gate — destructive operations require approval

Configuration

| Environment Variable | Default | Description | |---------------------|---------|-------------| | UE_WS_PORT | 9877 | WebSocket port for UE plugin connection |

Requirements

• Node.js >= 20.0.0
• Unreal Engine 5.4 - 5.7
• Python Editor Script Plugin enabled in UE (Edit → Plugins → Scripting) — required for Python-based automation
• UE Plugin: UnrealMasterAgent installed in your project

Testing

# 1134 TypeScript tests + 58 Python tests
npm test

# With coverage (thresholds enforced)
npm run test:coverage

Community Workflows

Browse, share, and import community-created workflows at Workflow Community.

• 22+ official workflows covering 14+ UE domains
• Community-created workflows with ratings and reviews
• Integration guides for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code

Import a Workflow

npx unreal-master-mcp-server import-workflow <url>

Import any workflow from the community platform or a local .mcp.json file directly into your MCP server's learned-workflows store.

Links

• GitHub Repository
• Workflow Community
• Documentation
• API Reference
• Contributing Guide
• Changelog

License

MIT - see LICENSE

Unreal Engine is a trademark of Epic Games, Inc. This project is not affiliated with or endorsed by Epic Games.