Godot AI MCP
MCP-сервер для движка Godot: подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен, скриптов и материалов
- 3 509 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Меняет файлы сцен, скриптов и ресурсов открытого проекта Godot
- Локальный сервер слушает порты на машине, хоть и только с loopback-доступом
Установка
- Работает в
Ручная установка
Скачай релиз с GitHub Releases и помести аддон в your-project/addons/godot_ai/. В Godot включи плагин: Project → Project Settings → Plugins → Godot AI. В доке Godot AI нажми Configure для своего клиента (Claude Code, Claude Desktop, Codex и другие) — команда для конфигурации сгенерируется автоматически.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Меняет файлы сцен, скриптов и ресурсов открытого проекта Godot
- Локальный сервер слушает порты на машине, хоть и только с loopback-доступом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Godot AI соединяет MCP-клиента с открытым редактором Godot через плагин-аддон и локальный Python-сервер. Агент получает десятки инструментов, чтобы строить сцены, редактировать узлы и GDScript, настраивать сигналы, UI, материалы, анимацию, частицы, камеры и окружение, а также искать файлы сцен и ресурсов в проекте. Соединение идет по двум локальным шагам с ротацией токенов доступа: от MCP-клиента до Python-сервера и от него до редактора по WebSocket, оба ограничены локальной машиной. C# поддерживается только для записи файлов и поиска символов, без сборки и вывода ошибок компилятора.
Для кого. Для разработчиков игр на Godot, которые хотят строить сцены и логику через агента прямо в открытом редакторе.
Подходит, если
- Нужно, чтобы агент создавал и редактировал узлы, сцены и GDScript-скрипты в открытом проекте Godot
- Нужна настройка UI, материалов, анимации, частиц или окружения через диалог с агентом
- Нужно быстро найти сцены или ресурсы определенного типа в большом проекте
- Нужно писать и запускать тесты для сцен Godot
Не подходит, если
- Проект на Godot ниже версии 4.7
- Нужна полноценная сборка и вывод ошибок компилятора C#: сервер этого не дает
- Godot закрыт или редактор не запущен: сервер работает только с открытым редактором
Пример запроса к агенту
Создай в текущей сцене Camera3D с именем MainCamera и подключи его сигнал к существующему скрипту игрокаMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
GODOT_AI_DISABLE_TELEMETRY- Установите в true, чтобы полностью отключить анонимную телеметрию использования.
Ограничения
Требует Godot 4.7 и выше в линейке 4.x, установленный uv для запуска Python-сервера, и хотя бы один MCP-клиент. C# поддерживается частично: только запись и поиск символов, без сборки. Контроль доступа не защищает от скомпрометированного процесса того же пользователя, на Windows также нет изоляции от других локальных учетных записей.
Как отключить. Отключите плагин Godot AI на вкладке Plugins окна Project Settings (меню Project) и удалите записи сервера в конфигурации вашего MCP-клиента.
Частые вопросы
Нужен ли аккаунт модели или облачная подписка?
Нет, сервер не выбирает провайдера модели, он только соединяет MCP-клиента с редактором Godot.
Собирает ли сервер данные о моем проекте?
Телеметрия записывает установку, событие, платформу и версию, но не код, содержимое сцен или имена проекта и файлов; путь к директории проекта хешируется. Отключается переменной GODOT_AI_DISABLE_TELEMETRY.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыАддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP для редактора Godot: агент правит сцены, запускает игру, замораживает время и проверяет свою работу тестом
Аддон делает редактор Godot 4.2 и новее MCP-сервером с более чем 150 операциями и набором, который растет по запросу агента.
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Godot AI (эта карточка) | да | API-ключ | 3 509 | |
| Roblox Studio MCP (сообщество, отладка и плейтесты) | нет | не нужна | 366 | MCP-сервер для Roblox Studio |
| Godot MCP Full Control | нет | не нужна | 513 | MCP-сервер на 157 инструментов для Godot 4 |
| Godot MCP Native | нет | не нужна | 874 | MCP-сервер для Godot 4 внутри самого редактора |
Из блога
Коротко о README
README описывает Godot AI как продакшен-готовый MCP-сервер для Godot с 46 инструментами и более чем 120 операциями для сцен, узлов, скриптов, сигналов, UI, материалов, анимации, частиц, камер и окружений. Архитектура состоит из трех локальных звеньев: MCP-клиент, Python-сервер на аутентифицированном HTTP и плагин редактора по аутентифицированному WebSocket, оба порта только для локальной машины. Поддерживаются Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor, VS Code и Oh My Pi. Лицензия MIT.