MCP Unreal Server

Name: MCP Unreal Server
Author: radial-hks

@radial-hks

Repository

About MCP Unreal Server

A MCP Server implementation for interacting with Unreal Engine instances through remote Python execution.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCP-Unreal-Server": {
      "command": "python",
      "args": [
        "-m",
        "src.mcp_server_unreal.server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Unreal Server?

MCP Unreal Server is a server implementation that enables interaction with Unreal Engine instances through remote Python execution. It is designed for developers who need to programmatically control Unreal Engine environments, run scripts, and monitor nodes.

How to use MCP Unreal Server?

Install dependencies via pip install -r requirements.txt, then start the server with python -m src.mcp_server_unreal.server. Connect to an Unreal instance using the connect tool (multicast group 239.0.0.1:6766 by default) and execute Python code with the execute tool, specifying node ID, code, and execution mode.

Key features of MCP Unreal Server

Automatic discovery of Unreal nodes via multicast
Real-time node status monitoring
Remote Python code execution in Unreal Engine environments
Support for attended and unattended execution modes
File execution and statement evaluation modes
Detailed logging to file (mcp_unreal.log) and console

Use cases of MCP Unreal Server

Automating gameplay testing by running Python scripts in Unreal
Integrating Unreal Engine into CI/CD pipelines for asset validation
Monitoring and managing multiple Unreal instances across a network
Prototyping game logic or editor extensions remotely

FAQ from MCP Unreal Server

How does MCP Unreal Server discover Unreal instances?

It uses multicast discovery on the default group endpoint 239.0.0.1:6766. Ensure Unreal instances are running with the MCP plugin and multicast traffic is allowed.

What execution modes are available?

Three modes are supported: MODE_EXEC_FILE (execute a Python file), MODE_EXEC_STATEMENT (execute a Python statement), and MODE_EVAL_STATEMENT (evaluate a Python expression).

Why are no Unreal nodes discovered?

Verify that Unreal instances are running and have the MCP plugin enabled. Check firewall settings for multicast traffic and inspect mcp_unreal.log for node status changes.

What logging options are configurable?

Logging can be adjusted in server.py: file logging level and console logging level can be set (e.g., DEBUG for files, INFO for console). Logs are written to mcp_unreal.log.

What are the runtime requirements?

The server requires Python and the dependencies listed in requirements.txt. It communicates with Unreal Engine via remote Python execution over the network.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K