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

Installation

# Clone repository
git clone https://github.com/your-org/mcp-unreal-server.git
cd mcp-unreal-server

# Install dependencies
pip install -r requirements.txt

Configuration

Network Settings

Configure multicast parameters in RemoteExecutionConfig:

# Default multicast settings (modify in server.py)
config.multicast_group_endpoint = ("239.0.0.1", 6766)

Logging

Modify logging configuration in server.py:

# Adjust log levels
file_handler.setLevel(logging.DEBUG)  # File logging
console_handler.setLevel(logging.INFO)  # Console logging

Usage

Starting the Server

python -m src.mcp_server_unreal.server

Supported Tools

Connect to Unreal Instance

{
  "host": "239.0.0.1",
  "port": 6766
}

Execute Python Code

{
  "node_id": "<unreal-node-id>",
  "code": "print('Hello Unreal')",
  "unattended": true
}

API Documentation

Resource Format

types.Resource(
    uri="unreal://<node_id>",
    name=f"Unreal Instance: {node_id}",
    description="Unreal Engine instance",
    mimeType="application/x-unreal"
)

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.log for node status changes

License

Apache-2.0 License

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

execute-python

A server implementation that enables remote Python code execution in Unreal Engine environments, featuring automatic Unreal node discovery and management through a multicast network.

Related MCP Servers

Blender MCP Server
cwahlfeldt
-
security
F
license
-
quality
A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
Last updated -
8
Python
Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
78
MIT License
Unitree Go2 MCP Server
lpigeon
A
security
A
license
A
quality
A server built on the Model Context Protocol that enables controlling the Unitree Go2 robot using natural language commands, which are translated into ROS2 instructions for the robot to perform corresponding actions.
Last updated -
12
33
Python
Apache 2.0
nUR MCP Server
nonead
A
security
F
license
A
quality
A Model Context Protocol server that enables natural language interactive control of Universal Robots collaborative robots, allowing users to control robot motion, monitor status, and execute programs through direct commands to large language models.
Last updated -
29
3
Python

View all related MCP servers

MCP Unreal Server