Godot MCP (satelliteoflove)
MCP для редактора Godot: агент правит сцены, запускает игру, замораживает время и проверяет свою работу тестом
- 184 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент меняет сцены и ресурсы проекта в открытом редакторе, поэтому нужна система контроля версий
- Инструмент `godot_exec` выполняет GDScript внутри запущенной игры
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/godot-mcp-satelliteofloveОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент меняет сцены и ресурсы проекта в открытом редакторе, поэтому нужна система контроля версий
- Инструмент `godot_exec` выполняет GDScript внутри запущенной игры
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту глаза и руки в редакторе Godot и в запущенной игре. Строит он вокруг идеи, что агент должен сам проверять свою работу: запускает игру, играет как человек и наблюдает, что произошло. Для этого есть детерминированный плейтест (игровые часы замораживаются, время идет заданными кусками или до выполнения условия, ввод вкладывается в окно), дешевое наблюдение за состоянием сущностей в виде JSON без снимков экрана, настоящий ввод (действия, геймпад, клавиши, мышь, текст) и настройка сценария скриптом GDScript прямо в игре. Всего 21 инструмент и 86 действий. Они читают и правят сцены и узлы, анимации, тайлы и GridMap, ресурсы, настройки проекта, профайлер и документацию Godot нужной версии. Инструменты разделены по границе чтения и записи, чтобы чтение можно было разрешить клиенту автоматически, а запись оставить под подтверждением. Аддон ставят командой `npx @satelliteoflove/godot-mcp --install-addon /путь/к/проекту` и включают в настройках проекта.
Для кого. Разработчикам игр на Godot, которые поручают агенту правки и хотят, чтобы он сам проверял результат прогоном игры, а не словами.
Подходит, если
- Босс-файт нужно проверить: агент замораживает время, спавнит босса и шагает по кадрам до нужного условия
- Игрок не может запрыгнуть на платформу, и агент вводит нажатия и читает позицию и скорость
- Раскладку заставки проверяют при разрешении 1280 на 720 по снимку игры
- Анимацию правят по ключевым кадрам, а редактор сразу показывает результат
- Скачки производительности ищут по метрикам профайлера с выделением всплесков
Не подходит, если
- Проект не на Godot: сервер связан с аддоном редактора
- Нужна готовая заготовка игры целиком: сервер редактирует и тестирует, а проект придумываете вы
- Редактор закрыт: без запущенного Godot с аддоном инструменты ничего не сделают
Пример запроса к агенту
Запусти игру с замороженным временем, переведи счетчик волны на третью, дождись появления босса и покажи позиции и состояние сущностейMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Работает только вместе с открытым редактором Godot, в который установлен и включен аддон. Нужен Node.js, сервер запускают через `npx -y @satelliteoflove/godot-mcp`. Инструмент `godot_exec` выполняет код GDScript внутри запущенной игры, поэтому не стоит отдавать его без подтверждения. Новые сцены создают прямой записью файла `.tscn` и затем открывают. Подробные конфигурации клиентов лежат в `INSTALL.md`, а проблемы подключения разбирает `docs/troubleshooting.md`. Список возможностей и их границ собран в `docs/tools/README.md`.
Как отключить. Удалите сервер в клиенте и выключите аддон в Project Settings, раздел Plugins; папку аддона можно удалить из проекта.
Частые вопросы
Как подключить Godot MCP?
Добавьте в конфигурацию клиента сервер `npx -y @satelliteoflove/godot-mcp`, затем поставьте аддон командой `npx @satelliteoflove/godot-mcp --install-addon /путь/к/проекту` и включите его в Project Settings, раздел Plugins.
Что такое детерминированный плейтест?
Игровые часы замораживают, время продвигают точными кусками или до выполнения условия, а ввод вкладывается в это окно. Наблюдение не гонится за игрой.
Нужны ли снимки экрана, чтобы увидеть игру?
Часто нет: состояние сущностей, позиции и скорости отдаются структурным JSON инструментом `godot_runtime_state`. Снимок экрана остается для случаев, когда он действительно нужен.
Сколько инструментов у сервера?
21 инструмент и 86 действий. Связанные операции собраны внутри одного инструмента, чтобы не раздувать контекст агента.
Как разрешить чтение без запросов?
Инструменты `godot_*_read` и другие только читающие можно разрешить клиенту автоматически, а записывающие оставить под подтверждением.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
Аддон делает редактор Godot 4.2 и новее MCP-сервером с более чем 150 операциями и набором, который растет по запросу агента.
Аддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godot MCP (satelliteoflove) (эта карточка) | нет | не нужна | 184 | |
| Godot MCP | нет | не нужна | 6 608 | другой сервер Godot; здесь упор на самопроверку: заморозка времени, ввод и состояние сущностей |
| Godot MCP Native | нет | не нужна | 874 | нативный сервер Godot; здесь аддон редактора и 21 инструмент с разделением чтения и записи |
Коротко о README
README объясняет, зачем нужен этот сервер: проверка работы агентом через игру. Далее идут быстрый старт из трех шагов, таблица инструментов, примеры запросов и ссылки на установку, документацию и разбор проблем.