Godot MCP ai-game.dev

Q: Как подключить Godot MCP к Claude Code?

Выполните по порядку npm install -g godot-cli, godot-cli install-plugin ./MyGodotProject, godot-cli login и godot-cli setup-mcp claude-code ./MyGodotProject. Затем откройте проект командой godot-cli open ./MyGodotProject, и редактор автоматически подключится.

Аддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL

316 ★ репозитория
Последний коммит 29 окт. 2026
Apache-2.0

MCP-сервер

ivanmurzak/godot-mcpАвтор:Ivan Murzak

Установка

Работает в: Claude Code
Cursor
GitHub Copilot
SourceCraft
Koda
Coddy

Ручная установка

npm install -g godot-cli

Затем godot-cli install-plugin ./MyGodotProject скачает аддон, добавит NuGet-пакеты в .csproj и включит плагин в project.godot.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Агент пишет и удаляет файлы проекта, сцены и скрипты, а `script-execute` компилирует и выполняет произвольный C# в редакторе
По умолчанию аддон подключается к облаку ai-game.dev, и данные редактора проходят через этот сервис
Вход выполняется по OAuth, учетные данные сохраняются на машине как общий для редактора доступ

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Godot MCP — аддон для редактора Godot на C#, который выставляет операции редактора как инструменты MCP. Claude, Cursor, Copilot и другие агенты могут создавать узлы, править сцены .tscn и ресурсы .tres и .res. Еще агент читает и пишет скрипты на C# и GDScript, делает скриншоты и вызывает методы. Всего 23 встроенных инструмента в девяти семействах. Основной слой называется RQL, язык запросов к редактору. Инструменты `rql-query`, `rql-mutate` и `rql-schema` читают и меняют узлы, свойства, ресурсы и настройки проекта одним запросом, например `nodes | where name starts-with "Enemy" | set Visible = false`. Изменения атомарны и откатываются обычной отменой, а параметр `dry_run` показывает результат заранее. Скрипты можно проверять и запускать в редакторе: `script-validate` разбирает GDScript, `script-execute` компилирует и выполняет C#. Подключение идет к облаку ai-game.dev либо к вашему серверу. Установку аддона и вход автоматизирует godot-cli.

Для кого. Для разработчиков игр на Godot с C#, которые хотят отдать агенту рутину редактора и настройку проекта.

Подходит, если

Нужно создать несколько узлов в сцене по описанию, например три куба по кругу радиусом 2
Надо массово поменять свойства узлов по условию, не кликая по каждому, одним запросом RQL
Агент должен увидеть результат: viewport, камеру или изолированный узел через инструменты скриншотов
Нужно подключить входные действия, автозагрузки и слои в project.godot без ручной правки
Требуется проверить GDScript на ошибки разбора инструментом `script-validate`

Не подходит, если

Проект на стандартной сборке Godot без C#: аддон не скомпилируется
Нужен только запуск проекта и отладка из терминала: для этого подойдут более простые MCP-серверы
Данные проекта нельзя отправлять в облако, а собственный сервер развернуть негде

Пример запроса к агенту

Создай в открытой сцене три куба по кругу радиусом 2, назови их Cube1–Cube3 и сделай скриншот вьюпорта

MCP

Транспорт: http
Авторизация: OAuth

Ограничения

Нужны Godot 4.3 или новее в редакции Mono (C# и .NET) и .NET 8 SDK. Проект должен объявлять те же пакеты NuGet, что и аддон, иначе код не скомпилируется, и это делает `godot-cli install-plugin`.

По умолчанию аддон подключается к облаку ai-game.dev и просит вход через OAuth, для работы без облака нужен собственный сервер. Семейства `runtime-errors`, `console` и `reflection` относятся к запущенной игре. Захват ошибок игры отключен по умолчанию и включается в коде вызовом `builder.WithRuntimeErrorCapture()`.

Как отключить. Отключите плагин godot_mcp в настройках проекта Godot и удалите папку addons/godot_mcp. Затем уберите пакеты NuGet аддона из .csproj и запись сервера из конфигурации агента.

Частые вопросы

Как подключить Godot MCP к Claude Code?

Выполните по порядку `npm install -g godot-cli`, `godot-cli install-plugin ./MyGodotProject`, `godot-cli login` и `godot-cli setup-mcp claude-code ./MyGodotProject`. Затем откройте проект командой `godot-cli open ./MyGodotProject`, и редактор автоматически подключится.

Что такое RQL и зачем он нужен?

RQL — язык запросов к редактору. Три инструмента заменяют десятки: `rql-query` читает, `rql-mutate` меняет узлы, ресурсы и настройки проекта, `rql-schema` показывает доступные источники и классы.

Можно ли обойтись без облака ai-game.dev?

Да, аддон поддерживает собственный сервер. Локальный сервер аддон может скачать и запустить сам, либо вы собираете и запускаете его вручную. Есть и Docker-образ aigamedeveloper/mcp-server.

Поддерживает ли аддон GDScript?

Да. Инструменты для чтения, создания, правки и удаления скриптов работают с файлами .cs и .gd, а `script-validate` проверяет GDScript. Сам аддон при этом написан на C#.

Чем Godot MCP похож на Unity-MCP?

Это версия того же автора для Godot. Стек MCP и рефлексии общий и берется из NuGet, а подключение идет к тому же облачному серверу ai-game.dev или к вашему собственному.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Godot AI

Официальный

MCP-сервер для движка Godot: подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен, скриптов и материалов

MCP-серверРасширенный доступ3,3 тыс.

Godot MCP Native

MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js

MCP-серверШирокий доступ863

Godlink MCP — доступ ИИ-агента к редактору Godot

Godlink MCP

MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки

MCP-серверШирокий доступ446

Godot MCP

MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента

MCP-серверРасширенный доступ6,4 тыс.

Godot MCP Full Control

MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET

MCP-серверШирокий доступ505

Fennara Godot AI

Аддон и MCP-сервер для Godot: агент видит дерево сцены, ошибки и скриншоты запущенной игры и проверяет правки в редакторе

MCP-серверШирокий доступ314

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
Godot MCP ai-game.dev (эта запись)	нет	OAuth	316
Godot MCP Native	нет	не нужна	863	сервер внутри редактора Godot 4 без Node.js и на GDScript; здесь аддон на C# и общий облачный бэкенд с языком запросов RQL
Godot AI	да	API-ключ	3 271	подключает Claude Code, Claude Desktop и Codex к живому редактору; этот аддон добавляет атомарные запросы RQL с откатом и режим `dry_run`

Коротко о README

README начинается с быстрого старта через godot-cli и справочника по инструментам. Дальше идут три способа установки аддона, подключение к облаку или своему серверу и работа внутри запущенной игры.

Бейдж для README

Сообщить о проблеме