Godot MCP Runtime
MCP-сервер для Godot 4: правка сцен без редактора и запуск игры с кадрами, вводом и профилированием, без аддона в проекте
- 97 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный GDScript и имитирует ввод в запущенной игре
- Сервер запускает процесс Godot и создает и изменяет файлы сцен и скриптов проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/godot-mcp-runtimeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольный GDScript и имитирует ввод в запущенной игре
- Сервер запускает процесс Godot и создает и изменяет файлы сцен и скриптов проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Godot MCP Runtime дает агенту две группы возможностей для движка Godot 4. Первая — правка без окна редактора: создание сцен, добавление узлов, настройка свойств, подключение скриптов и сигналов, проверка GDScript. Вторая — управление запущенной игрой: после `run_project` сервер подключает автозагрузку `McpBridge` с TCP-слушателем на localhost. Через мост агент снимает скриншоты (превью 960x540 и полный PNG с оценкой, не пуст ли кадр), имитирует ввод пакетами действий, обходит живое дерево Control-узлов с позициями и текстом, выполняет GDScript с доступом к SceneTree и снимает профиль функций, FPS и этапов отрисовки. Команда `render_movie` отдельным коротким запуском рендерит заданное число кадров и сообщает, пустые ли они и движутся ли. Сервер не требует аддона: запускается через `npx -y godot-mcp-runtime`, в проект ничего не коммитится, при выходе мост убирается. Режим `background: true` не показывает окно игры, `attach: true` подключается к игре, которую запустил внешний процесс. Можно вести несколько проектов одновременно.
Для кого. Разработчики игр на Godot 4.5 и новее, которые пишут игру с Claude Code или Cursor и хотят, чтобы агент сам проверял результат запуском.
Подходит, если
- Агент добавил кнопку, и нужно убедиться, что сцена загружается и кнопка реагирует
- Нужно собрать сцену из узлов и скриптов без ручной работы в редакторе
- Игра тормозит, и надо найти самые дорогие функции GDScript по профилю
- Надо проверить интерфейс на живом дереве узлов
- CI или отладчик запускают игру сами, и агенту нужно подключиться к ней через `attach`
Не подходит, если
- Нужно оценить, насколько игра приятна: README прямо говорит, что инструмент не заменяет игровое тестирование человеком
- Проект на Godot 3 или версии ниже 4.5: сервер рассчитан на Godot 4.5 и новее
- Нужен аддон внутри редактора с графической панелью: здесь аддона нет
Пример запроса к агенту
Запусти мой проект, нажми кнопку «Играть» в главном меню и сделай скриншот, чтобы убедиться, что загрузилась первая сцена.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
GODOT_PATHобязательная- Путь к исполняемому файлу Godot
DEBUG- Включает отладочный вывод сервера
GODOT_MCP_DISABLE_ELICITATION- Отключает запросы подтверждения у клиента
Ограничения
Нужны Node.js 20 или новее и Godot 4.5 и новее, путь к исполняемому файлу Godot передается в переменной `GODOT_PATH`. Живой GDScript выполняется с полным доступом к дереву сцены запущенной игры, поэтому запускайте его на своих проектах. Для режима `attach` вывод `get_debug_output` недоступен: stdout и stderr идут только от процессов, которые запустил сам MCP. В фоновом режиме окно на Windows скрыто, на других системах уведено за экран, а ввод мыши все равно может проходить сквозь окно. Сервер не отвечает на вопрос, интересна ли игра.
Как отключить. Удалите блок `godot` из конфигурации MCP. Если ставили глобально, снимите пакет командой `npm uninstall -g godot-mcp-runtime`; в проекте ничего не остается.
Частые вопросы
Нужен ли аддон Godot?
Нет. Сервер подключает временную автозагрузку `McpBridge` при запуске игры и убирает ее при остановке, в версионный контроль ничего не попадает.
Как проверить, что сервер подключен?
Попросите агента вызвать `check_project`. Если вернулась строка версии Godot, например `4.5.stable`, все работает.
Чем отличается от серверов с аддоном?
Большинство серверов с управлением запущенной игрой ставят аддон в проект и требуют коммитить его. Здесь нужен только запуск через `npx`, зато управление запущенной игрой есть и без аддона.
Какие версии Godot поддерживаются?
Godot 4.5 и новее, нужен Node.js 20 или выше.
Может ли агент выполнять свой код в игре?
Да. Инструмент живого GDScript компилирует и запускает произвольный код с доступом к SceneTree запущенной игры, поэтому применяйте его на своих проектах.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP для редактора Godot: агент правит сцены, запускает игру, замораживает время и проверяет свою работу тестом
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
Аддон делает редактор Godot 4.2 и новее MCP-сервером с более чем 150 операциями и набором, который растет по запросу агента.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godot MCP Runtime (эта карточка) | нет | не нужна | 97 | |
| Godot MCP Toolkit | нет | не нужна | 128 | набор инструментов Godot без запуска игры с мостом выполнения |
| Godot MCP Enhanced | нет | не нужна | 104 | расширенный MCP для Godot с аддоном в проекте |
Коротко о README
Описаны возможности правки без редактора и управления запущенной игрой, мост на localhost, фоновый режим и режим подключения. Есть сравнение с другими серверами для Godot, быстрый старт с конфигурацией для `npx`, список документации по инструментам и благодарности.