Godot MCP Enhanced
Godot MCP Enhanced читает, правит, запускает и проверяет проекты Godot 4.5–4.7: сцены, скрипты, UI и тесты с защитой путей.
- 104 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сервер пишет и запускает код GDScript, а у скрипта игры полный доступ к системе.
- Операции записи меняют файлы проекта, удаление требует подтверждения.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/godot-mcp-enhancedОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер пишет и запускает код GDScript, а у скрипта игры полный доступ к системе.
- Операции записи меняют файлы проекта, удаление требует подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту слой инструментов поверх Godot: сцены, скрипты, интерфейс, анимации, физика, частицы, навигация, звук, тесты, экспорт и параметрические 3D-ассеты. В версии из README 46 инструментов и 272 действия. Три слоя (без интерфейса, редактор и мост к запущенной игре) избавляют от необходимости открывать редактор: агент создает проект, пишет скрипты, запускает игру, снимает скриншот и проверяет результат. Упор сделан на проверку: `run_and_verify` разбирает ошибки, `validate_scripts` компилирует скрипты, `qa` запускает детерминированные наборы тестов с фиксированным зерном случайных чисел, `verify_delivery` проверяет сцену и производительность. Действия в редакторе попадают в родной стек отмены Godot. Описания инструментов написаны на китайском, README есть и на английском.
Для кого. Разработчикам игр на Godot, которые отдают агенту рутину и хотят проверяемый цикл: правка, запуск, проверка.
Подходит, если
- Агент создает прототип 2048 или змейки и запускает его тесты.
- Скрипт после правки проверяют компиляцией, а не на глаз.
- Баг воспроизводят детерминированно: тот же ввод и то же зерно дают тот же результат.
- Ассистент снимает скриншот игры и показывает текущий вид.
- Нужно сохранить рабочий проект и отменить неудачную правку одним `Ctrl+Z`.
Не подходит, если
- Нужна полная изоляция: песочница сервера защищает от ошибок, но не дает непробиваемой границы.
- Игра работает на Godot ниже версии 4.5.
- Описания инструментов обязательно нужны на английском.
Пример запроса к агенту
Создай проект 2048 по шаблону, запусти его тесты и покажи скриншот текущего состояния игры.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ALLOWED_PROJECT_PATHS- Список разрешенных путей к проектам; по умолчанию доступ запрещен
GODOT_MCP_SANDBOX- Значение `disabled` отключает сканирование скриптов; только для разработки
GODOT_MCP_ALLOW_UNSAFE- Разрешение небезопасных операций; для изоляции задают `false`
Ограничения
Нужны Node.js 18 и новее и Godot 4.x (проверялся с 4.6). Для `run_tests` потребуется аддон GUT. Защита (список разрешенных путей, сканирование опасных вызовов, подтверждение удаления) предотвращает ошибки, но GDScript имеет полный доступ к системе, и автор советует для реальной изоляции контейнер или виртуальную машину. При запуске сервер обращается к реестру npm за обновлениями. Лицензия указана как MIT, с авторским правом исходного Coding-Solo/godot-mcp.
Как отключить. Сначала `npx godot-mcp-enhanced uninstall --dry-run`, затем `--yes`: команда убирает регистрации клиентов и следы в проекте. С флагом `--purge` удаляется и `~/.godot-mcp/`.
Частые вопросы
Как подключить к Claude Code?
Командой `claude mcp add -s user godot -- npx -y godot-mcp-enhanced`. Единая настройка для 15 клиентов: `npx godot-mcp-enhanced setup`.
Нужно ли ставить Godot отдельно?
Нет, `npx godot-mcp-enhanced install` скачает официальную сборку с проверкой SHA512 в `~/.godot-mcp/godot/<версия>/` и внесет ее в список путей.
Какие шаблоны игр есть?
Три: `2048`, `snake` и `breakout`. Команда `npx godot-mcp-enhanced init my-game --template=2048` создает проект с демо, документом GDD и наборами тестов.
Чем он отличается от Coding-Solo/godot-mcp?
Автор приводит руководство по миграции: возможности сохраняются, а добавлены три слоя архитектуры, защита, проверки качества и матрица совместимости версий.
Как удалить сервер и следы в проекте?
Сначала `npx godot-mcp-enhanced uninstall --dry-run` покажет, что будет убрано, затем `--yes` удалит регистрации в клиентах и ссылки в проекте. Флаг `--purge` стирает и `~/.godot-mcp/` вместе со скачанным Godot.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
Аддон делает редактор Godot 4.2 и новее MCP-сервером с более чем 150 операциями и набором, который растет по запросу агента.
MCP для редактора Godot: агент правит сцены, запускает игру, замораживает время и проверяет свою работу тестом
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godot MCP Enhanced (эта карточка) | нет | не нужна | 104 | |
| Godot MCP | нет | не нужна | 6 620 | базовый сервер для сцен и запуска; Enhanced добавляет три слоя, защиту путей и детерминированную проверку |
| Godot MCP Native | нет | не нужна | 874 | работает как встроенный слой Godot; Enhanced сочетает headless, редактор и мост к игре |
Коротко о README
Расширенная версия MCP для Godot с тремя слоями, защитой путей и цепочкой проверок. Включены навыки для агентов, шаблоны игр и команды `qa`, `init`, `gif` и `web` для проверки и публикации в браузере.