How devoe09/unrealmcp works
UnrealMCP is an Unreal Editor plugin that exposes editor operations to MCP-compatible clients over TCP. A request is accepted and parsed by the server, queued for game-thread execution, dispatched to a command handler, and answered to the client. The graph preserves documented command domains and the toolbar indicator. Several domains are grouped because their handlers share one implementation file; their individual call details were not sampled, so those dispatch links are documented at the architecture level rather than inferred from imports.
Main entry points: MCPTCPServer.cpp Game-thread queue · UnrealMCPModule.cpp Plugin module · MCPStatusWidget.cpp Toolbar status widget
Components 19
Plugin lifecycle
- Plugin module
Source/UnrealMCP/Private/UnrealMCPModule.cpp
TCP and protocol
- TCP server
Source/UnrealMCP/Private/MCPTCPServer.cpp - Protocol parsing
Source/UnrealMCP/Private/MCPTCPServer.cpp - Game-thread queue
Source/UnrealMCP/Private/MCPTCPServer.cpp
Editor commands
- Core commands
Source/UnrealMCP/Private/MCPTCPServer.cpp - World and levels
Source/UnrealMCP/Private/MCPTCPServer.cpp - Actor operations
Source/UnrealMCP/Private/MCPTCPServer.cpp - Property system
Source/UnrealMCP/Private/MCPTCPServer.cpp - Outliner folders
Source/UnrealMCP/Private/MCPTCPServer.cpp - Assets and content
Source/UnrealMCP/Private/MCPTCPServer.cpp - Blueprint editing
Source/UnrealMCP/Private/MCPTCPServer.cpp - Material editing
Source/UnrealMCP/Private/MCPTCPServer.cpp - UMG editing
Source/UnrealMCP/Private/MCPTCPServer.cpp - AI authoring
Source/UnrealMCP/Private/MCPTCPServer.cpp - Viewport tools
Source/UnrealMCP/Private/MCPTCPServer.cpp - Python execution
Source/UnrealMCP/Private/MCPTCPServer.cpp
Editor interface
- Toolbar status widget
Source/UnrealMCP/Private/MCPStatusWidget.cpp
Other components
- MCP client
- Unreal Editor
Connections 30
- MCP client → TCP server: sends TCP
README.md - TCP server → Protocol parsing: parses requests
README.md - Protocol parsing → Game-thread queue: enqueues commands
README.md - Game-thread queue → Core commands: dispatches
README.md - Game-thread queue → World and levels: dispatches
README.md - Game-thread queue → Actor operations: dispatches
README.md - Game-thread queue → Property system: dispatches
README.md - Game-thread queue → Outliner folders: dispatches
README.md - Game-thread queue → Assets and content: dispatches
README.md - Game-thread queue → Blueprint editing: dispatches
README.md - Game-thread queue → Material editing: dispatches
README.md - Game-thread queue → UMG editing: dispatches
README.md - Game-thread queue → AI authoring: dispatches
README.md - Game-thread queue → Viewport tools: dispatches
README.md - Game-thread queue → Python execution: dispatches
README.md - Core commands → Unreal Editor: controls editor
README.md - World and levels → Unreal Editor: manages levels
README.md - Actor operations → Unreal Editor: edits actors
README.md - Property system → Unreal Editor: reads and writes
README.md - Outliner folders → Unreal Editor: organizes actors
README.md - Assets and content → Unreal Editor: manages assets
README.md - Blueprint editing → Unreal Editor: edits graphs
README.md - Material editing → Unreal Editor: edits materials
README.md - UMG editing → Unreal Editor: edits UMG
README.md - AI authoring → Unreal Editor: authors AI
README.md - Viewport tools → Unreal Editor: controls viewport
README.md - Python execution → Unreal Editor: executes Python
Source/UnrealMCP/Private/MCPTCPServer.cpp - Plugin module → TCP server: starts server
Source/UnrealMCP/Private/UnrealMCPModule.cpp - Plugin module → Toolbar status widget: registers widget
Source/UnrealMCP/Private/UnrealMCPModule.cpp - Toolbar status widget → TCP server: reads status
Source/UnrealMCP/Private/MCPStatusWidget.cpp