unreal-mcp

{"type": "text"}# unreal-mcp

MCP-сервер, который управляет запущенным редактором Unreal Engine из Claude.

Он использует собственный протокол Epic Python Remote Execution: UDP-мультикаст на 239.0.0.1:6766 для обнаружения экземпляров редактора, а затем TCP-канал для выполнения Python внутри редактора.

Claude  ──stdio──▶  unreal-mcp  ──UDP discovery + TCP──▶  Unreal Editor (PythonScriptPlugin)

Клиентская часть протокола не включена в поставку. Сервер находит remote_execution.py Epic в вашей установке движка во время выполнения, поэтому он продолжает работать во всех версиях движка.

Требования

• Unreal Engine 5.x (разрабатывалось на 5.6)

• Python 3.10+ и uv

Related MCP server: unreal-mcp

Установка

1. Включите удалённое выполнение в Unreal — этот шаг все пропускают

Удалённое выполнение по умолчанию ВЫКЛЮЧЕНО. Без него редактор невидим для обнаружения, и все инструменты будут давать сбой.

1. Edit > Plugins → включите Python Editor Script Plugin → перезапустите.

2. Edit > Project Settings > Plugins > Python → отметьте Enable Remote Execution.

3. Перезапустите редактор.

2. Установка

cd unreal-mcp
uv sync

3. Регистрация в Claude

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "unreal": {
      "command": "uv",
      "args": ["--directory", "E:\\Maya\\unreal-mcp", "run", "unreal-mcp"]
    }
  }
}

Затем начните новый разговор — серверы, добавленные в середине сеанса, не подхватываются уже запущенным чатом.

Если ваш движок установлен не в стандартное место, задайте UNREAL_ENGINE_ROOT:

"env": { "UNREAL_ENGINE_ROOT": "D:\\Epic\\UE_5.6" }

Инструменты

Инструменты списков поддерживают постраничный вывод с помощью limit / offset и возвращают has_more и next_offset.

Как возвращаются результаты

Тела инструментов отправляются в редактор в обёртке, которая присваивает значение переменной result и выводит его в формате JSON между маркерами. Это предотвращает повреждение полезной нагрузки случайным print() или строкой журнала Unreal, а также превращает исключение внутри редактора в структурированную ошибку вместо трассировки, затерянной в stdout.

Примечание по безопасности

unreal_execute_python выполняет неизолированный код в интерпретаторе редактора с полным доступом к модулю unreal. Он может изменять или удалять содержимое проекта. Относитесь к нему так же осторожно, как к консоли Python в самом редакторе.

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

«No running Unreal Editor was discovered» — почти всегда это настройка Enable Remote Execution, описанная выше. Подтвердите с помощью unreal_get_status.

«Lost the connection ... while running a command» — редактор был закрыт или заблокирован модальным диалогом. Закройте диалог и повторите попытку; сеанс автоматически переобнаружится.

Несколько открытых редакторов — выигрывает первый обнаруженный узел. unreal_get_status перечисляет их все, чтобы вы могли понять, какой из них какой.