Unreal MCP

MCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/unreal-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'PYTHON=<значение PYTHON>' unrealMCP -- uvx --directory '<значение PYTHON>' run unreal_mcp_server.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"unrealMCP","type":"stdio","command":"uvx","args":["--directory","<значение PYTHON>","run","unreal_mcp_server.py"],"env":{"PYTHON":"<значение PYTHON>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "unrealMCP": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add unrealMCP --env 'PYTHON=<значение PYTHON>' -- uvx --directory '<значение PYTHON>' run unreal_mcp_server.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.unrealMCP]
command = "uvx"
args = ["--directory", "<значение PYTHON>", "run", "unreal_mcp_server.py"]
env = { PYTHON = "<значение PYTHON>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "unrealMCP": {
      "type": "local",
      "command": [
        "uvx",
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "environment": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uvx",
      "args": [
        "--directory",
        "<значение PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ],
      "env": {
        "PYTHON": "<значение PYTHON>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PYTHONобязательная: Path to the Python folder containing unreal_mcp_server.py

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 4e5f00d.

Текст для агента

Склонируй https://github.com/chongdashu/unreal-mcp, в папке Python выполни uv venv и uv pip install -e ., собери плагин UnrealMCP в проекте Unreal и пропиши сервер в конфигурации MCP командой uv --directory <путь>/Python run unreal_mcp_server.py.

Другие способы из описания автора

git clone https://github.com/chongdashu/unreal-mcp.git
cd unreal-mcp/Python
uv venv
uv pip install -e .

Нужен Python 3.10 или новее и uv. Отдельно соберите плагин UnrealMCP в проекте Unreal 5.5 и включите его в Edit, Plugins.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект связывает кодового агента с редактором Unreal Engine через протокол MCP. Он состоит из плагина на C++, который поднимает TCP-сервер внутри редактора, и Python-сервера на FastMCP, который принимает команды агента и передает их плагину. Через естественный язык агент создает и удаляет акторы, задает их трансформации, собирает классы блупринтов с компонентами, добавляет узлы и переменные в граф и наводит камеру вьюпорта. Автор помечает проект как экспериментальный, а список возможностей приведен в документации Docs.

Для кого. Для разработчиков игр и технических художников на Unreal Engine, которые хотят автоматизировать рутину в редакторе через агента.

Подходит, если

Нужно создавать и расставлять акторы или собирать блупринты командами на естественном языке
Нужно автоматизировать однотипные действия в редакторе Unreal Engine 5.5
Нужен мост между кодовым агентом и открытым проектом Unreal

Не подходит, если

Нужна стабильная работа в продакшене, а не экспериментальный инструмент
Нет возможности собрать плагин на C++ и поставить Unreal Engine 5.5

Пример запроса к агенту

Создай в текущем уровне куб и точечный свет, подними свет на два метра и наведи на него камеру вьюпорта

Ограничения

Проект помечен как экспериментальный, возможны ломающие изменения и пробелы в документации. Нужны Unreal Engine 5.5 или новее, Python 3.10 или новее и менеджер uv, а плагин на C++ требуется собрать в проекте. Редактор Unreal должен быть открыт и запущен, связь идет по локальному TCP-порту 55557. Пакета на PyPI нет, сервер запускается из исходников через uv.

Как отключить. Удалите запись сервера из конфигурации MCP клиента и отключите плагин UnrealMCP в разделе Edit, Plugins редактора Unreal.

MCP

Транспорт: stdio
Авторизация: не нужна

Проверка безопасности

Сервер выполняется локально и управляет открытым редактором Unreal через TCP
Изменяет содержимое проекта: создает акторы, блупринты и узлы графа

Коротко о README

README представляет мост между AI-клиентами вроде Cursor, Windsurf и Claude Desktop и редактором Unreal Engine по протоколу MCP. Проект состоит из примера Unreal-проекта, плагина на C++ с нативным TCP-сервером и Python-сервера на FastMCP, который загружает модули инструментов для акторов, блупринтов, узлов и редактора. Установка описана в двух частях: сборка плагина в Unreal 5.5 и настройка Python-окружения через uv, после чего сервер прописывается в конфигурацию MCP-клиента командой uv run. Статус проекта явно назван экспериментальным. Лицензия MIT.

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

Это готовый продукт?

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

Что нужно, чтобы сервер заработал?

Собранный плагин UnrealMCP в проекте, запущенный редактор Unreal 5.5 и Python-сервер, поднятый через uv. Связь идет по локальному TCP-порту.

Superpowers

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.

Скиллы Мэтта Покока для инженеров

Skills For Real Engineers

Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.

Spec Kit

Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

Superpowers

Скиллы Мэтта Покока для инженеров

Spec Kit

Референсные MCP-серверы