Godot MCP Toolkit
Аддон делает редактор Godot 4.2 и новее MCP-сервером с более чем 150 операциями и набором, который растет по запросу агента.
- 131 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент меняет сцены, скрипты и настройки проекта и запускает игру в вашем редакторе.
- Мост загружается через `npx` из npm при первом подключении.
Установка
- Работает в
Ручная установка
Godot Asset Store: Godot MCP Toolkit, Download, Install; затем Project Settings, Plugins, ActiveВручную: скачать архив из релизов GitHub и распаковать в `addons/`. Конфигурацию клиента запишет пункт Write .mcp.json.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент меняет сцены, скрипты и настройки проекта и запускает игру в вашем редакторе.
- Мост загружается через `npx` из npm при первом подключении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Godot MCP Toolkit работает внутри редактора и передает агенту сцены, скрипты, узлы и запуск игры. Агент создает узлы, правит GDScript, ставит клетки TileMap, ключует дорожки анимации и читает живой узел во время тестового запуска, пока вы смотрите в редактор. Операции упакованы в до 113 инструментов: постоянное ядро и 28 групп по запросу, поэтому набор стартует с примерно 8 800 токенов. Свои инструменты на GDScript или C# подключаются через API расширений с горячей перезагрузкой. Связь идет по WebSocket на `127.0.0.1` от порта 6550, мост поставляет npm-пакет `@npgamedev/godot-mcp-server`.
Для кого. Разработчики игр на Godot, которые поручают агенту работу в открытом редакторе и хотят видеть результат сразу.
Подходит, если
- Сцену надо собрать из описания, не открывая инспектор вручную.
- Агент должен запустить игру и прочитать состояние узлов во время игры.
- Проект на C# и GDScript требует собственных инструментов для агента.
- Контекст ограничен, и список инструментов должен расти постепенно.
Не подходит, если
- Версия Godot ниже 4.2 или проект на мобильном или веб-редакторе.
- Не установлен Node.js 22 для моста.
- Открытое окно редактора недоступно, например сборка в CI без графики.
Пример запроса к агенту
Создай сцену уровня с игроком и тайлмапом, запусти игру и покажи значения позиции игрока через пять секунд.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Godot 4.2 или новее и Node.js 22 или новее, работает только на ПК. Часть операций недоступна на старых версиях Godot. Редактор должен быть открыт, плагин включен. Это независимый проект сообщества. Раз в сутки аддон проверяет обновления на GitHub, отключается настройкой `mcp_toolkit/updates/check_for_updates`. Лицензия: MIT по README, на GitHub определена как NOASSERTION. Мост запускается через `npx` и скачивается при первом подключении, закрепите версию, если нужен воспроизводимый запуск.
Как отключить. Снимите флажок Active у плагина в Project Settings, Plugins и удалите `addons/godot_mcp_toolkit/` вместе с записью `godot-mcp-toolkit` в `.mcp.json`.
Частые вопросы
Как плагин пишет конфигурацию клиента?
Через меню Project, Tools, MCP Toolkit, Write .mcp.json. Файл запускает мост командой `npx -y @npgamedev/godot-mcp-server`.
Почему инструментов до 113, а операций больше 150?
Связанные действия сгруппированы под одним инструментом. Ядро всегда включено, 28 групп подгружаются по запросу агента.
Что делать на Windows, если `npx` не запускается?
Обернуть вызов в `cmd /c npx -y @npgamedev/godot-mcp-server` или обновить клиент.
Уходят ли данные проекта в сеть?
Нет, кроме ежедневной проверки обновлений: она не передает данных проекта и отключается настройкой.
Как закрепить версию моста?
Добавьте `@<версия>` к имени пакета в `.mcp.json`. Док плагина также имеет режимы закрепления.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
MCP для редактора Godot: агент правит сцены, запускает игру, замораживает время и проверяет свою работу тестом
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
Godot MCP Enhanced читает, правит, запускает и проверяет проекты Godot 4.5–4.7: сцены, скрипты, UI и тесты с защитой путей.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godot MCP Toolkit (эта карточка) | нет | не нужна | 131 | |
| Godot MCP Full Control | нет | не нужна | 513 | 157 инструментов в одном списке; здесь ядро плюс 28 групп по запросу и API расширений на GDScript и C# |
| Godot AI | да | API-ключ | 3 509 | подключает агентов к работающему редактору; здесь упор на ограниченный контекст и собственные инструменты |
Коротко о README
README ведет через установку аддона, включение, запись `.mcp.json` и первый запрос. Архитектура и проверки вынесены в отдельные документы.