Unreal Engine MCP

ChiR24/Unreal_mcp· Проверено 12.11.2026· 1 тыс.на GitHub

Даёт агенту работать в открытом Unreal Editor: расставлять акторы, собирать Blueprints и UI, настраивать материалы, свет и эффекты, запускать игру в редакторе и снимать скриншоты.

2 реализации:

Плагин на C++ сам отдаёт MCP по HTTP; один инструмент unreal со встроенным поиском по 450+ возможностям, Unreal Engine 5.0–5.8, доступ по токену проекта.

Как подключить

Что сделать до подключения

Unreal Engine от 5.0 до 5.8

Поставить плагин EngineWire из Fab (Library → Fab Library → Install to Engine) или скопировать папку EngineWire из релиза в Plugins/ проекта

Открыть проект и дождаться сборки плагина: в строке состояния появится MCP :3000 (0)

Проверить, что включён Enable Native MCP Server в Project Settings → Plugins → EngineWire, и взять токен из <проект>/Saved/MCP/capability-token

X-MCP-Capability-Token

токен создаётся плагином в файле <проект>/Saved/MCP/capability-token; храните как пароль

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http unreal http://127.0.0.1:3000/mcp \
  --header 'X-MCP-Capability-Token: <токен из Saved/MCP/capability-token>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.unreal]
url = "http://127.0.0.1:3000/mcp"
http_headers = { "X-MCP-Capability-Token" = "<токен из Saved/MCP/capability-token>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "unreal": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "unreal": {
      "type": "http",
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "unreal": {
      "httpUrl": "http://127.0.0.1:3000/mcp",
      "headers": {
        "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "unreal": {
      "httpUrl": "http://127.0.0.1:3000/mcp",
      "headers": {
        "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "unreal": {
        "type": "remote",
        "url": "http://127.0.0.1:3000/mcp",
        "headers": {
          "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:3000/mcp
Request headers: X-MCP-Capability-Token: <токен из Saved/MCP/capability-token>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "unreal": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "X-MCP-Capability-Token": "<токен из Saved/MCP/capability-token>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

unrealищет, описывает и выполняет возможности редактора

Экспериментальный: плагин UnrealMCP плюс сервер на Python, отдельные инструменты для акторов, Blueprints и их графов; Unreal Engine 5.5+.

Как подключить

Что сделать до подключения

Unreal Engine 5.5 или новее и Python 3.12 или новее

Скопировать MCPGameProject/Plugins/UnrealMCP в папку Plugins проекта или взять готовый MCPGameProject

Включить плагин в Edit → Plugins (UnrealMCP в категории Editor) и перезапустить редактор

Сгенерировать файлы проекта Visual Studio и собрать проект с целью Development Editor

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio unreal-mcp \
  -- uv --directory '<путь к папке Python из репозитория>' run unreal_mcp_server.py

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.unreal-mcp]
command = "uv"
args = ["--directory", "<путь к папке Python из репозитория>", "run", "unreal_mcp_server.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "unreal-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "unreal-mcp": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к папке Python из репозитория>",
          "run",
          "unreal_mcp_server.py"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Python из репозитория>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Инструменты сервера

get_actors_in_levelперечисляет акторы уровня

find_actors_by_nameищет акторы по имени

create_actorсоздаёт актор

delete_actorудаляет актор

set_actor_transformдвигает, вращает и масштабирует

get_actor_propertiesчитает свойства актора

create_blueprintсоздаёт класс Blueprint

add_component_to_blueprintдобавляет компонент в Blueprint

set_physics_propertiesнастраивает физику компонента

compile_blueprintкомпилирует Blueprint

spawn_blueprint_actorставит актор из Blueprint

add_blueprint_event_nodeдобавляет узел события

add_blueprint_function_nodeдобавляет вызов функции

connect_blueprint_nodesсоединяет узлы графа

add_blueprint_variableдобавляет переменную

create_input_mappingсоздаёт привязку ввода

focus_viewportнаводит вьюпорт на актор

take_screenshotснимает вьюпорт

Что попросить агента

«Перечисли акторы на текущем уровне»В EngineWire агент найдёт нужную возможность через unreal (search, describe, execute), в unreal-mcp вызовет get_actors_in_level

«Поставь точечный свет на 300 единиц над началом координат»Агент выполнит создание актора через unreal, в unreal-mcp — create_actor с координатами

«Сними скриншот вьюпорта»Агент вызовет снимок через unreal, в unreal-mcp — take_screenshot

«Создай Blueprint <имя> с мешем куба и физикой и поставь его на уровень»В unreal-mcp агент вызовет create_blueprint, add_component_to_blueprint, set_physics_properties, compile_blueprint и spawn_blueprint_actor

Для каких задач

Перечислить акторы уровня и поставить точечный свет на 300 единиц над началом координат

Создать Blueprint с компонентами и собрать его граф событий

Сверстать виджеты UMG и проверить их по картинке-превью

Настроить ландшафт, растительность, свет, эффекты Niagara и графы PCG

Запустить игру в редакторе с имитацией ввода, прочитать логи и снять скриншот

Собрать билд проекта

Ограничения

EngineWire отдаёт один инструмент unreal: нужные действия агент ищет запросом, а удаление и рискованные правки выполняются только с отдельным согласием

Сборка EngineWire из исходников требует проект с кодом C++; проекту только на Blueprints нужен Fab или готовые бинарники, а бинарники работают только с той версией движка и платформой, под которые собраны

unreal-mcp помечен как экспериментальный: возможны ломающие изменения, для рабочих проектов автор его не советует; последние изменения в репозитории — апрель 2025 года

При прямом HTTP-подключении к EngineWire сессия рвётся при закрытии редактора; прокси npx unreal-engine-mcp-server держит её до перезапуска

Если не работает

Клиент не подключается по HTTP, в строке состояния редактора написано MCP off

Включите Enable Native MCP Server в настройках плагина и перезапустите редактор: сборка из Fab поставляется с выключенным сервером.

HTTP-подключение отвечает 401 Invalid capability token

Скопируйте токен из файла Saved/MCP/capability-token заново, без перевода строки в конце.

Каждый вызов через npx-сервер отвечает NOT_CONNECTED

Запустите редактор с плагином и проверьте строку состояния MCP :3000. Если порт меняли, задайте тот же адрес в UNREAL_MCP_URL.

Агент раз за разом получает UNKNOWN_TOOL, UNKNOWN_ACTION или UNDECLARED_PARAMETER

Модель угадывает имена. Добавьте в промпт или инструкции проекта строку «Use the unreal tool: search, then describe, then execute, and copy each nextCall».

Вызов падает с EDITOR_BLOCKED

В редакторе висит модальное окно, например запрос на сохранение. Закройте его и повторите вызов.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
EngineWire	ChiR24	1 тыс.	HTTP	токен	1	10 ноября 2026
unreal-mcp	Chong-U (chongdashu)	2,1 тыс.	локально	не нужен	18	22 апреля 2025

Частые вопросы

Какой вариант выбрать?

EngineWire шире: 450+ возможностей от уровней до Gameplay Ability System, Niagara и Movie Render Queue, поддержка Unreal Engine 5.0–5.8. unreal-mcp проще и экспериментальный: акторы, Blueprints, узлы графа и вьюпорт.

Как подключить EngineWire к Claude Desktop?

Claude Desktop запускает только локальные команды, поэтому нужен прокси: command npx, args -y unreal-engine-mcp-server и переменная UE_PROJECT_PATH с папкой проекта. Прокси сам найдёт токен; нужен Node.js 20.19 или новее.

Где взять токен EngineWire?

Плагин создаёт его для каждого проекта в файле <проект>/Saved/MCP/capability-token. Чтобы сменить токен, удалите файл и перезапустите редактор.

Агент не знает названий действий. Как он работает?

Инструмент unreal ищет возможности по 2–4 словам, например spawn actor или save level, затем запрашивает точное описание и выполняет. В ответ приходит отчёт о том, что изменилось.

Можно подключиться к Unreal на другом компьютере?

Сервер EngineWire слушает только 127.0.0.1 и работает без TLS. Для доступа с другой машины нужен SSH-туннель, например ssh -L 3000:127.0.0.1:3000, или TLS-прокси.

Работает ли сервер из России?

Оба сервера работают на вашем компьютере и слушают только 127.0.0.1; ключи сторонних сервисов не нужны.

Unreal Engine MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы