Godot MCP Full Control

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

505 ★ репозитория
Последний коммит 9 окт. 2026
MIT

MCP-сервер

tugcantopaloglu/godot-mcpАвтор:Tugcan Topaloglu

Установка

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

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

git clone https://github.com/tugcantopaloglu/godot-mcp.git && cd godot-mcp && npm install && npm run build

Сборка из исходников, нужен Node.js 18 и новее.

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

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

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

Инструменты читают, пишут и удаляют файлы проекта, а game_eval выполняет произвольный код GDScript с правами процесса Godot
Инструменты game_http_request и game_websocket отправляют сетевые запросы из запущенной игры
Пока GODOT_MCP_ALLOWED_DIRS не задана, разрешен любой корень проекта на машине

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

Что делает

Сервер дает агенту почти весь набор действий, которые разработчик выполняет в Godot вручную. Часть инструментов работает без запущенной игры: они читают и правят файлы сцен .tscn, подключают скрипты к узлам, создают ресурсы .tres, меняют настройки project.godot, автозагрузки, карту ввода и пресеты экспорта. Новый проект создается с нуля, в том числе под .NET и C#, а скрипты проверяются на синтаксис и типы без запуска игры. Вторая часть, инструменты с префиксом game_, управляет работающей игрой через TCP-сервер на 127.0.0.1:9090. Агент выполняет код GDScript с возвращаемым значением, читает и пишет свойства узлов, вызывает методы, добавляет и убирает узлы, переключает сцены, шлет нажатия клавиш, мыши и геймпада, а также запрашивает FPS, память и число вызовов отрисовки. Отдельные группы закрывают физику, камеры, звук, анимации, частицы, навигацию, сети и интерфейс. Это расширение проекта Coding-Solo godot-mcp, в котором было 20 инструментов. Автор довел число до 157, добавил защиту путей, постраничное чтение логов и поддержку Godot 4.7.

Для кого. Для разработчиков игр на Godot 4.4 и новее, которые хотят отдать Claude Code, Cursor или Cline правку сцен, настройку проекта и проверку игры во время работы.

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

Нужно собрать сцену и подключить к узлам скрипты, не открывая редактор: сервер правит файлы .tscn напрямую
Агент написал скрипт на GDScript, и его надо проверить на синтаксис и типы, учитывая автозагрузки проекта, до запуска игры
Игру надо протестировать в движении: удержать клавиши движения, прочитать свойства узлов, лог и ошибки и затем поправить код
Проект переводится на C#: сервер создает проект под .NET и генерирует скрипты с частичным классом
Сборки экспортируются из CI: инструмент export_project запускает экспорт без редактора

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

Проект работает на Godot ниже 4.4: скрипт операций без окна и функции UID требуют 4.4 и новее
Нужен самый простой набор из нескольких инструментов: 157 определений нагружают контекст агента, в каталоге есть более компактный Godot MCP от Coding-Solo
Нужна связь с открытым редактором в реальном времени: этот сервер правит файлы и общается с запущенной игрой, а не с окном редактора
На машине лежат чужие или непроверенные проекты: код агента выполняется с правами процесса Godot
Агент работает без Node.js 18 и новее: сервер собирается из исходников командами npm install и npm run build

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

Открой проект в /games/platformer, запусти игру, удержи клавишу D две секунды, прочитай позицию узла Player и ошибки из лога, затем поправь скрипт движения

MCP

Транспорт: stdio
Авторизация: не нужна

Переменные окружения

GODOT_PATH: Путь к исполняемому файлу Godot, переопределяет автоопределение
DEBUG: Значение true включает подробные логи сервера
GODOT_MCP_ALLOWED_DIRS: Список корневых каталогов, которыми ограничены инструменты проекта и экспорт

Ограничения

Сервер нужно собрать самому: клонировать репозиторий, выполнить npm install и npm run build, затем указать путь к build/index.js в настройках MCP. Нужны Godot 4.4 или новее и Node.js 18 и новее. Для C# дополнительно требуются .NET SDK 8.0 и сборка Godot .NET.

Инструменты game_* работают только после ручной подготовки проекта: файл build/scripts/mcp_interaction_server.gd копируется в проект и регистрируется как автозагрузка McpInteractionServer. Проверки путей действуют для аргументов инструментов, но код, который агент выполняет в игре, работает с правами процесса Godot. Для чужого кода автор советует отдельную учетную запись или контейнер.

Лог хранит последние 2000 строк на поток, по 4096 символов в строке. Проект сторонний и неофициальный. Доступность из России автор не описывает.

Как отключить. Удалите запись godot из настроек MCP вашего агента. Для игр уберите автозагрузку McpInteractionServer в Project Settings и удалите скопированный файл mcp_interaction_server.gd. Каталог с собранным сервером можно стереть.

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

Чем Godot MCP Full Control отличается от Godot MCP от Coding-Solo?

Это расширенная версия того проекта. В оригинале 20 инструментов для управления проектом и сценами, здесь 157: добавлены выполнение кода в запущенной игре, ввод с мыши и геймпада, физика, звук, анимации, сеть, C#, проверка скриптов и постраничные логи. Оригинал проще и легче для контекста агента.

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

Соберите сервер командами npm install и npm run build, затем добавьте в настройки MCP запись godot с командой node и путем к build/index.js. При необходимости задайте переменную GODOT_PATH и DEBUG=true для подробных логов. Для Cursor запись кладется в .cursor/mcp.json проекта, для Cline в cline_mcp_settings.json.

Какая версия Godot нужна?

Godot 4.4 и новее: на 4.4 опираются скрипт операций без окна и функции UID. Автор проверял работу на Godot 4.7. Для проектов на C# дополнительно нужны .NET SDK 8.0 и сборка Godot .NET.

Как ограничить доступ к файлам?

Задайте переменную GODOT_MCP_ALLOWED_DIRS со списком корневых каталогов, разделитель двоеточие или запятая, а в Windows точка с запятой. Тогда инструменты проекта, поиск проектов и экспорт работают только внутри этих каталогов, а символические ссылки разрешаются до проверки. Пока переменная не задана, разрешен любой корень проекта.

Умеет ли сервер проверять GDScript без запуска игры?

Да, инструмент validate_script проверяет один файл на синтаксис и типы, а validate_scripts проходит по всем измененным в git или по всем файлам проекта. С версии 3.1 проверка учитывает автозагрузки, поэтому обращения к синглтонам не дают ложных ошибок.

Обсуждение

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

MCP-серверы

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 ai-game.dev

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

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

Godot AI

Официальный

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

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

GoPeak

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

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

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

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

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
Godot MCP Full Control (эта запись)	нет	не нужна	505
Godot MCP	нет	не нужна	6 420	оригинальный проект на 20 инструментов, на котором основана эта версия
Godot AI	да	API-ключ	3 271	подключает агента к работающему редактору Godot, а не правит файлы и игру напрямую
Godot MCP Native	нет	не нужна	863	MCP-сервер для Godot 4 внутри самого редактора

Коротко о README

Документ начинается с благодарности автору исходного godot-mcp и перечня того, что добавлено в версиях 3.0 и 3.1: поддержка .NET, диагностика GDScript, исправления в операциях и слияние событий карты ввода. Дальше идут группы инструментов с описаниями, полная таблица на 157 позиций, требования, примеры настройки для Claude Code, Cline и Cursor и подготовка проекта для инструментов времени выполнения. Завершают описание переменные окружения, правила постраничного чтения логов, проверки для контрибьюторов и схема из двух каналов связи: запуск Godot в режиме без окна и TCP-сервер внутри игры.

Бейдж для README

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