unreal-api-mcp — справочник API Unreal Engine
unreal-api-mcp
Справочник C++ API Unreal Engine по MCP: точные сигнатуры, пути include и устаревшие функции без чтения исходников
- 99 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Сервер читает только локальную базу API и скачивает ее при первом запуске, к проекту и секретам доступа нет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/unreal-api-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер читает только локальную базу API и скачивает ее при первом запуске, к проекту и секретам доступа нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
unreal-api-mcp отдает агенту сведения об API Unreal Engine из локальной базы SQLite, по одной базе на версию движка. Сервер закрывает типичную ошибку агентов в C++ для Unreal: придуманную сигнатуру функции, неверный путь в `#include` или вызов устаревшего метода. Инструментов пять. `search_unreal_api` ищет функции и классы по ключевым словам, `get_function_signature` возвращает точную сигнатуру с параметрами и типом результата, `get_include_path` подбирает `#include` для типа, `get_class_reference` выдает карточку класса со списком членов, `get_deprecation_warnings` подсказывает замену для устаревшего вызова. В базу входят модули Engine Runtime, Editor и Developer, встроенные плагины вроде Enhanced Input, Gameplay Abilities, Common UI, Niagara и Chaos, а также внутренности Blueprint: 158 подклассов UK2Node и модули BlueprintGraph, KismetCompiler, GraphEditor. Установленный Unreal Engine не нужен. При первом запуске сервер скачивает базу нужной версии в `~/.unreal-api-mcp/`, а при старте проверяет обновления.
Для кого. Разработчики на Unreal Engine C++, которые пишут код с Claude Code, Cursor или Windsurf и хотят, чтобы агент сверял API со справочником.
Подходит, если
- Агент назвал функцию, и нужно сверить ее сигнатуру и тип результата
- Нужен точный `#include` для класса вроде `ACharacter`
- Проект на Unreal 5.5 или 5.7, и надо узнать, не устарел ли вызов в этой версии
- Пишете собственные узлы K2 или редакторные инструменты и ищете нужные классы Blueprint
- Хочется сэкономить токены и не отправлять агенту огромные файлы движка
Не подходит, если
- Нужны сторонние плагины и ассеты из Marketplace: сервер их не знает, для них остается исходный код проекта
- Нужно понять логику внутри файла движка, например тело функции: база хранит сигнатуры, комментарии и списки членов
- Работа идет на Unity или Godot: сервер описывает только Unreal
Пример запроса к агенту
Какая сигнатура у AActor::GetActorLocation и какой include нужен для ACharacter в Unreal 5.5?MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
UNREAL_VERSION- Версия Unreal Engine, например 5.5 или 5.7.3
UNREAL_PROJECT_PATH- Путь к проекту, версия берется из поля EngineAssociation файла .uproject
Ограничения
Покрыты Unreal Engine до версии из списка выпусков базы; если базы под патч-версию нет, сервер берет базу минорной версии, например 5.7 вместо 5.7.3. Без переменной `UNREAL_VERSION` или `UNREAL_PROJECT_PATH` сервер отвечает по Unreal 5.7. Первый запуск требует сети для загрузки базы. Сторонние плагины и ассеты Marketplace не входят. Автор советует добавить в `CLAUDE.md` короткий фрагмент о том, когда звать инструменты: без него агент может о них не вспомнить. Результаты бенчмарка в README получены автором на 14 вопросах и двух тестовых наборах, их стоит проверять на своем проекте.
Как отключить. Удалите блок `unreal-api` из конфигурации MCP и, если нужно, папку `~/.unreal-api-mcp/` с загруженными базами.
Частые вопросы
Как подключить unreal-api-mcp к Claude Code или Cursor?
Добавьте в `.mcp.json` или настройки MCP сервер с командой `uvx` и аргументом `unreal-api-mcp`, а в env задайте `UNREAL_VERSION`, например 5.5. Отдельная установка Unreal Engine не нужна.
Какие версии Unreal Engine поддерживаются?
Список баз лежит на странице релиза db-v1 в репозитории, новые версии CI находит и собирает по понедельникам. Для патч-версии без своей базы сервер берет базу минорной версии.
Видит ли сервер мой проект и плагины?
Нет. Сервер отвечает по общей базе движка и встроенных плагинов, код вашего проекта и сторонние плагины в нее не попадают. Для них агент читает исходники проекта.
Нужно ли ставить Unreal Engine, чтобы сервер работал?
Нет. Сервер использует собственную базу SQLite, скачанную в `~/.unreal-api-mcp/`, установленный движок не требуется.
Что делать, если агент не вызывает инструменты?
Добавьте в `CLAUDE.md` или аналогичный файл правил фрагмент из README: когда звать какой инструмент. Автор отмечает, что без него агент может не вспомнить о сервере.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер с точной документацией Unity API для Claude Code и Cursor: сигнатуры, пространства имен и устаревшие методы
MCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
Unreal MCP на Python: 253 действия в 21 области, от акторов и Blueprint до материалов и кинематографики, плюс выполнение любого Python в редакторе
Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
MCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| unreal-api-mcp — справочник API Unreal Engine (эта карточка) | нет | не нужна | 99 | |
| UnrealClaude | нет | не нужна | 1 031 | управление редактором Unreal из Claude Code |
| Flopperam Unreal Engine MCP | нет | API-ключ | 1 117 | автоматизация редактора и сцены Unreal |
Коротко о README
Раздел быстрого старта сводит установку к одному блоку конфигурации, выбор версии движка и пять инструментов. Дальше идут состав базы по типам (классы, структуры, перечисления, функции, свойства), задержки запросов в миллисекундах и бенчмарк с методикой. Отдельный раздел показывает фрагмент для `CLAUDE.md`.