What is Unreal Mcp

unreal-mcp is an MCP server designed for Unreal Engine that utilizes the Unreal Python Remote Execution protocol, allowing for seamless integration and automation within Unreal projects.

Use cases

Use cases for unreal-mcp include automating repetitive tasks in game development, integrating AI tools for content creation, and enhancing workflows in virtual production environments.

How to use

To use unreal-mcp, set up your Unreal Engine project by enabling the Python Editor Script Plugin and the Remote Execution option. Then, configure your MCP Client (like Claude or Cursor) to connect to the server using Node.js.

Key features

Key features of unreal-mcp include no need for additional UE plugins, faster development for new tools and features without C++ coding, and full support for the Unreal Engine Python API.

Where to use

unreal-mcp can be used in game development, virtual production, and any project that requires automation or scripting within Unreal Engine.

unreal-mcp

MCP server for Unreal Engine that uses Unreal Python Remote Execution

Twitter · Discord

⚡ Differences

This server does not require installing a new UE plugin as it uses the built-in Python remote execution protocol.

Adding new tools/features is much faster to develop since it does not require any C++ code.

It can support the full Unreal Engine Python API

⚠️ Note

• This is not an official Unreal Engine project.
• Your AI agents or tools will have full access to your Editor.
• Review any changes your Client suggests before you approve them.

📦 Installation

📋 Requirements

• 🔧 Unreal Engine 5.4+ (verified, may work with earlier versions)
• 🟢 Node.js with npx
• 🤖 MCP Client (Claude, Cursor, etc.)

1. Setting up your Editor:
   • Open your Unreal Engine project
   • Go to Edit -> Plugins
   • Search for “Python Editor Script Plugin” and enable it
   • Restart the editor if prompted
   • Go to Edit -> Project Settings
   • Search for “Python” and enable the “Enable Remote Execution” option

2. Set up your Client:
   • Edit your Claude (or Cursor) config

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "@runreal/unreal-mcp"
      ]
    }
  }
}

🔧 Troubleshooting

If you get an error similar to MCP Unreal: Unexpected token 'C', Connection... it means that the mcp-server was not able to connect to the Unreal Editor.

• Make sure that the Python Editor Script Plugin is enabled and that the Remote Execution option is checked in your project settings.
• Try also changing your bind address from 127.0.0.1 to 0.0.0.0 but note that this will allow connections from your local network.
• Restart your Unreal Editor fully.
• Fully close/open your client (Claude, Cursor, etc.) to ensure it reconnects to the MCP server. (File -> Exit on windows).
• Check your running processes and kill any zombie unreal-mcp Node.js processes.

🛠️ Available Tools

🤝 Contributing

Please feel free to open issues or pull requests. Contributions are welcome, especially new tools/commands.

License MIT