MCP-сервер для Unreal Engine, использующий Unreal Python Remote Execution

Twitter · Discord

⚡ Различия

Этот сервер не требует установки нового плагина UE, так как использует встроенный протокол удалённого выполнения Python.

Добавление новых инструментов и функций разрабатывается гораздо быстрее, так как не требует кода на C++.

Он поддерживает полный API Python Unreal Engine

⚠️ Примечание

• Это не официальный проект Unreal Engine.
• Ваши AI-агенты или инструменты получат полный доступ к вашему редактору.
• Изучить любые изменения, предложенные клиентом, прежде чем их одобрить.

📦 Установка

📋 Требования

• 🔧 Unreal Engine 5.4+ (проверено, возможно работать с более ранними версиями)
• 🟢 Node.js с NPX
• 🤖 Клиент MCP (Claude, Cursor и др.)

1. Настройка вашего редактора:

• Откройте свой проект Unreal Engine
• Перейти на Edit -> Plugins
• Выполните поиск «Python Editor Script Plugin» и включите его
• Перезапустить редактор по запросу
• Перейти на Edit -> Project Settings
• Поиск «Python» и включение опции «Enable Remote Execution»

2. Настройте клиента:

• Редактировать конфигурацию Claude (или Cursor)

🔧 Устранение неполадок

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