Fennara Godot AI MCP
Аддон и MCP-сервер для Godot: агент видит дерево сцены, ошибки и скриншоты запущенной игры и проверяет правки в редакторе
- 314 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Записывает и обновляет файлы проекта и выполняет скрипты в открытом редакторе Godot
- Ставит аддон с родной библиотекой и локальный демон, которые держат связь агента с редактором
- Встроенный чат отправляет запросы облачным провайдерам с вашими ключами
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.sh | shmacOS и Linux. На Windows: irm https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.ps1 | iex. Затем fennara install в папке проекта.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Записывает и обновляет файлы проекта и выполняет скрипты в открытом редакторе Godot
- Ставит аддон с родной библиотекой и локальный демон, которые держат связь агента с редактором
- Встроенный чат отправляет запросы облачным провайдерам с вашими ключами
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Fennara Godot AI соединяет ИИ-ассистента с открытым редактором Godot по протоколу MCP. Агент получает обратную связь самого движка: дерево сцен, диагностику скриптов, скриншоты, ошибки времени выполнения и результаты проверки сцен. Установка добавляет в проект аддон addons/fennara/, маленький CLI fennara, локальный MCP-сервер и демон, который передает запросы от MCP и чата в открытый редактор. Подключать можно Codex, Claude Code, Cursor и еще восемь клиентов, от Claude Desktop до Kiro. Все инструменты про Godot. Агент записывает файлы проекта и сразу получает диагностику, правит сцену разовым скриптом и изучает узлы, ресурсы и классы. Он же проверяет сцены, запускает игру, читает логи и делает скриншоты. Для работы без внешнего агента в редакторе есть встроенное окно чата.
Для кого. Для разработчиков игр на Godot, которые работают с Claude Code, Codex, Cursor или другим MCP-агентом и хотят, чтобы он проверял правки в самом редакторе.
Подходит, если
- Агент правит сцены и скрипты Godot вслепую и не видит ошибок разбора
- Нужно, чтобы ассистент сделал скриншот запущенной игры и сверил результат с задачей
- Требуется читать ошибки времени выполнения и логи без копирования их в чат
- В проекте несколько репозиториев или рабочих деревьев, и каждое подключение должно работать со своим проектом
- Хотите работать и из внешнего MCP-агента, и из чата прямо в редакторе
Не подходит, если
- Нужна версия Godot ниже 4.5: она не поддерживается
- Нужен macOS на процессоре Intel или Linux на ARM: поддерживаются только Windows x86_64, Linux x86_64 и macOS arm64
- Нужен инструмент, который меняет проект без открытого редактора: Fennara опирается на запущенный Godot
Пример запроса к агенту
Открой сцену главного меню в Godot, проверь ее на ошибки, запусти игру и пришли скриншот после нажатия кнопки «Играть»MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
FENNARA_PROJECT_PATH- Абсолютный путь к проекту Godot для привязки подключения к одному проекту.
FENNARA_DISABLE_TELEMETRY- Значение true отключает ежедневное анонимное событие.
Ограничения
Нужен Godot 4.5 или новее и одна из платформ: Windows x86_64, Linux x86_64 или macOS arm64. Родная библиотека для macOS не нотаризована Apple, поэтому на этой системе лучше ставить через CLI: ручная распаковка ZIP вызывает предупреждение безопасности. Встроенный чат использует веб-движок платформы (WebView2, WKWebView или управляемый CEF на Linux), MCP-инструменты работают и без него. Раз в сутки уходит анонимное событие с идентификатором установки, версиями и системой; его отключают в настройках или переменными `FENNARA_DISABLE_TELEMETRY=true` и `DO_NOT_TRACK=1`.
Как отключить. Закройте Godot и удалите папку addons/fennara/ и каталог .fennara/ проекта, затем уберите запись Fennara из конфигурации MCP вашего агента.
Частые вопросы
Как поставить Fennara для Godot?
Откройте последний релиз, скачайте fennara-addon-latest.zip и распакуйте папку addons/fennara/ в проект. Другой путь: установить CLI скриптом install.sh (на Windows install.ps1) и выполнить `fennara install` в папке проекта.
Как подключить Codex или Claude Code?
В редакторе откройте Chat Settings, раздел MCP Apps, найдите приложение и нажмите Set Up. Из терминала Codex подключает команда `fennara mcp-setup --codex`, флаги для других клиентов покажет `fennara mcp-setup --help`. Перед изменением конфигурации Fennara сохраняет резервную копию.
Чем внешний MCP отличается от встроенного чата?
Внешние приложения работают на своих моделях и подписках. Встроенный чат настраивается отдельно: ключи облачных провайдеров ваши (BYOK) или локальные Ollama и LM Studio.
Попадет ли аддон в экспорт игры?
Нет. При экспорте плагин убирает свою автозагрузку и пропускает `res://addons/fennara/` и `res://.fennara/`, потом возвращает проект. В CI, где аддон исключен через `.gitignore`, перед запуском Godot выполните `fennara prepare-export --project путь`.
Что отправляет телеметрия?
Не более одного анонимного события в сутки: случайный UUID установки, версии Fennara и Godot, система и архитектура процессора. Данных проекта, путей, промптов, логов, скриншотов и учетных данных в нем нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыАддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер для движка Godot: подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен, скриптов и материалов
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Fennara Godot AI (эта запись) | нет | не нужна | 314 | |
| Godot AI | да | API-ключ | 3 271 | подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен и материалов |
| Godot MCP | нет | не нужна | 6 407 | запускает редактор и проекты из агента, без встроенного чата |
| Godot MCP Native | нет | не нужна | 863 | работает внутри редактора без Node.js и читает отладчик |
Коротко о README
README начинается с требований и состава установки, потом дает два способа поставить аддон и шаги подключения провайдера или MCP-приложения. В конце разделы об обновлении, конфиденциальности и ссылки на ролики.