UnrealRemoteMCP

What is UnrealRemoteMCP?

UnrealRemoteMCP is a plugin that implements an MCP Server (Model Context Protocol) using Unreal Engine’s built-in Python scripting. It runs a Streamable HTTP server inside the Unreal Editor, allowing AI clients to connect and assist developers with tasks like debugging, batch processing, and automation workflows.

How to use UnrealRemoteMCP?

Clone the repository to the Unreal Engine plugins directory, install Python dependencies (httpx, mcp[cli], anyio, pywin32) using uv or pip, enable the plugin in Edit → Plugins, set MCP Setting → Enable to True, then start the server with the console command MCP.Start (or enable AutoStart). Connect any MCP client (e.g., Cursor, Cherry Studio) using Streamable HTTP to http://localhost:<port>/mcp.

Key features of UnrealRemoteMCP

• Starts an MCP Server directly in Unreal Editor.
• Exposes tools like get_unreal_state and run_python_script.
• Easily extendable by adding new tools in common_tools.py.
• Supports batch tasks and AI-assisted debugging.
• Works with any MCP client (Cursor, Cherry Studio, etc.).

Use cases of UnrealRemoteMCP

• AI provides context for error logs, helping to quickly locate issues.
• Automate repetitive batch tasks like deleting actors or modifying configurations.
• Build automated workflows with tools like n8n for non‑programmer team members.
• Let AI write and execute Python scripts to manipulate the Unreal scene.

FAQ from UnrealRemoteMCP

What dependencies are required to run UnrealRemoteMCP?

Python 3.11, either uv or pip, and the packages httpx, mcp[cli], anyio, and pywin32 must be installed to the plugin’s Content/Python/Lib/site-packages directory.

Why can’t my client connect to the server?

Ensure the URL includes the /mcp path (e.g., http://127.0.0.1:8422/mcp). If you changed the port, run MCP.Restart in the Unreal console after saving the new port.

How do I refresh the tool list when a client doesn’t see updates?

In the Unreal console, run MCP.Reload. If that doesn’t work, use MCP.Restart and then reconnect the client.

Can I connect to UnrealRemoteMCP from a remote machine?

Yes, replace 127.0.0.1 with the local IP of the machine running Unreal Editor, and ensure the port is allowed through the firewall.

Is there any authentication or transport security?

No authentication is documented. The server uses Streamable HTTP on a configurable port.