Godlink MCP — доступ ИИ-агента к редактору Godot
Godlink MCP
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
- 446 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент пишет и удаляет файлы и папки проекта, правит скрипты и настройки проекта
- Инструменты запускают игру из редактора, отправляют ей ввод и читают логи
- Сервер слушает локальный порт 6505 для связи с Godot и порт 6510 для визуализатора, в котором код правится прямо в браузере
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/godlink-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет и удаляет файлы и папки проекта, правит скрипты и настройки проекта
- Инструменты запускают игру из редактора, отправляют ей ввод и читают логи
- Сервер слушает локальный порт 6505 для связи с Godot и порт 6510 для визуализатора, в котором код правится прямо в браузере
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Godlink MCP, в репозитории Godot MCP, состоит из плагина для редактора Godot и MCP-сервера на Node.js. Агент через сервер читает и меняет сцены, узлы, свойства, скрипты и настройки проекта в открытом редакторе, а плагин выполняет эти команды. Инструментов 69, и они делятся на семь наборов: операции со сценами (23), проект и запуск игры (28), скрипты и файлы (8), просмотр файлов (4), отмена и пакетные изменения (4), генерация 2D-спрайтов из SVG (1) и визуализатор (1). С их помощью агент создает целое дерево узлов одним вызовом, назначает текстуры, формы, меши и материалы, привязывает скрипты и сигналы, запускает игру, отправляет ей ввод, снимает скриншоты и читает ошибки с логами. Команда `map_project` открывает в браузере по адресу localhost:6510 визуализатор проекта: граф скриптов и связей между ними, переменные, функции и сигналы выбранного скрипта, поиск использований перед рефакторингом и сцены с правкой свойств узлов. Код можно менять прямо в визуализаторе, изменения синхронизируются с Godot.
Для кого. Для разработчиков игр на Godot 4.4 и новее, которые работают с Claude, Cursor, Cline или Windsurf и хотят поручить агенту правку сцен и скриптов.
Подходит, если
- Нужно собрать уровень или сцену: агент создает дерево узлов целиком и задает свойства, текстуры и формы за один вызов
- Агент должен запустить игру, отправить ей ввод, снять скриншот и прочитать ошибки, не выходя из диалога
- Требуется переименовать или переместить файлы проекта с обновлением ссылок на них
- Нужно увидеть связи между скриптами на графе и найти все использования перед рефакторингом
- Вы пробуете крупную правку и хотите, чтобы пакет изменений применился целиком или не применился вовсе
Не подходит, если
- Нужно собрать игру целиком без вашего участия: автор отмечает, что агент слабее на сложных интерфейсах, составных сценах и части свойств узлов
- Редактор Godot работает на удаленной машине: сервер принимает подключения только с локального компьютера
- Вы ведете несколько проектов в нескольких окнах редактора одновременно: поддерживается один экземпляр Godot
- Версия Godot ниже 4.4: плагин рассчитан на 4.4 и новее
- Правки агента хочется откатывать сочетанием Ctrl+Z: встроенная отмена Godot их не видит
Пример запроса к агенту
Создай в моем проекте Godot сцену платформы с персонажем и скриптом движения, запусти игру, пришли скриншот и список ошибок из логаMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Godot 4.4 или новее и Node.js. Сервер работает на локальной машине без удаленных подключений. К одному экземпляру редактора можно подключить несколько клиентов, но все они делят один проект.
Плагин пишет изменения на диск, поэтому Ctrl+Z их не откатывает. Для отмены попросите агента вызвать инструмент `mcp_undo`.
Плагин лежит в Asset Store Godot под названием Godlink MCP. Для Godot от 4.4 до 4.6 его ищут во вкладке AssetLib под названием Godot AI Assistant tools MCP, а при ручной установке копируют папку `addons/godot_mcp/` в проект.
Как отключить. Отключите плагин на вкладке Plugins в Project Settings и удалите сервер `godot` из конфигурации клиента, в Claude Code это команда `claude mcp remove godot`. Папку `addons/godot_mcp/` при желании удалите из проекта.
Частые вопросы
Как подключить Godot MCP к Claude Code?
Выполните `claude mcp add godot -- npx -y godot-mcp-server`, затем поставьте плагин в Godot и включите его в настройках проекта. После перезапуска клиента и проекта Godot покажет статус подключения.
Что значат надписи MCP: Agent Active, No Agent и Disconnected?
Зеленая Agent Active значит, что клиент подключен и работает. Оранжевая No Agent значит, что Godot нашел сервер, но ни один клиент его не использует, и тогда помогает перезапуск клиента. Красная Disconnected значит, что сервер не запущен: проверьте установку Node.js и сохраненный конфиг.
Как запустить Godot MCP на Windows?
В конфиге клиента вместо `npx` указывают `cmd` с аргументами `/c`, `npx`, `-y` и `godot-mcp-server`. Остальные шаги те же, что на Mac и Linux.
Можно ли откатить изменения, сделанные агентом?
Да, через инструмент `mcp_undo`: попросите агента отменить правку. Ctrl+Z в редакторе Godot не работает, потому что плагин пишет изменения на диск.
Как открыть карту проекта в браузере?
Попросите агента вызвать `map_project`. В браузере откроется визуализатор с графом скриптов, их переменными, функциями и сигналами.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
Аддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер для движка Godot: подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен, скриптов и материалов
MCP-сервер для Godot 4: агент создает сцены и скрипты, запускает игру, читает ошибки и отладчик, подтягивает бесплатные ассеты
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godlink MCP — доступ ИИ-агента к редактору Godot (эта запись) | нет | не нужна | 446 | |
| Godot MCP | нет | не нужна | 6 407 | запускает редактор, выполняет проекты и правит сцены прямо из агента |
| Godot MCP Full Control | нет | не нужна | 505 | 157 инструментов для Godot 4, в том числе скрипты на GDScript и .NET |
| Godot AI | да | API-ключ | 3 271 | подключает Claude Code, Claude Desktop и Codex к работающему редактору для сцен, скриптов и материалов |
Коротко о README
Описание ведет по четырем шагам: установить Node.js, поставить плагин, добавить сервер в конфиг клиента и перезапустить клиент вместе с проектом. Далее идут таблица инструментов по категориям, схема связи клиента, сервера и редактора через WebSocket на порту 6505 и перечень текущих ограничений.