Facilitates executing Python code remotely within Unreal Engine instances, supporting multiple execution modes including file execution and statement evaluation.
Enables remote Python code execution in Unreal Engine environments, supporting both attended and unattended execution modes, file execution, and statement evaluation through an automatic node discovery system.
MCP Unreal Server
A server implementation for interacting with Unreal Engine instances through remote Python execution.
Features
🚀 Unreal Instance Management
Automatic discovery of Unreal nodes via multicast
Real-time node status monitoring
Resource listing through LSP-compatible clients
💻 Remote Execution
Execute Python code in Unreal Engine environments
Support for both attended and unattended execution modes
File execution and statement evaluation modes
📊 Logging & Monitoring
Detailed logging to file (
mcp_unreal.log)Console logging with different verbosity levels
Node connection health monitoring
Related MCP server: Unity MCP Integration
Installation
Configuration
Network Settings
Configure multicast parameters in RemoteExecutionConfig:
Logging
Modify logging configuration in server.py:
Usage
Starting the Server
Supported Tools
Connect to Unreal Instance
Execute Python Code
API Documentation
Resource Format
Execution Modes
Mode | Description |
MODE_EXEC_FILE | Execute Python file |
MODE_EXEC_STATEMENT | Execute Python statement |
MODE_EVAL_STATEMENT | Evaluate Python expression |
Troubleshooting
Common Issues:
No nodes discovered: Verify Unreal instances are running with MCP plugin
Execution timeout: Check firewall settings for multicast traffic
Connection drops: Monitor
mcp_unreal.logfor node status changes
License
Apache-2.0 License