Godot MCP Native

Установка

Работает в

• Claude Code
• Cursor
• Codex
• Cline
• OpenCode
• Claude Desktop
• SourceCraft
• Koda
• Coddy

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

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

Что делает

Godot MCP Native — MCP-сервер для Godot, оформленный как плагин редактора. Он написан на GDScript и запускается внутри самого редактора Godot 4, поэтому Node.js и сторонние пакеты не нужны. Агент подключается по HTTP к адресу http://localhost:9080/mcp, порт меняется в настройках, и получает 155 инструментов: 30 основных и 125 дополнительных. Инструменты разбиты на шесть групп. Узлы: создание, свойства, сигналы, группы, пакетные правки одним действием отмены. Скрипты: чтение, создание, проверка синтаксиса GDScript и C#, поиск и переименование символов. Сцены: структура, сохранение, вкладки. Редактор: запуск и остановка проекта, снимок экрана, пресеты экспорта. Отладка: точки останова, стек, переменные, профилировщики и зонд в запущенной игре. Проект: настройки, ресурсы, тесты, карта ввода. Агентам с доступом к оболочке (Codex, Claude Code, Cursor) автор предлагает командную строку gdmcp. У нее около 33 доменных команд, а схемы дополнительных инструментов подгружаются по запросу, и все 155 описаний не занимают контекст модели. В папке skills/gdmcp лежит парный скилл, который учит агента работать с этой командой.

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

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

Создай главное меню с кнопками Играть, Настройки и Выход, привяжи к кнопке Играть скрипт загрузки уровня и проверь скрипт на ошибки

MCP

Транспорт

http

Авторизация

не нужна

Ограничения

• Сервер работает, пока открыт редактор Godot 4.x или запущен режим `--mcp-server`; без редактора инструментов нет.
• Режим stdio в документации быстрого старта помечен как недоступный, рабочий вариант — HTTP на порту 9080.
• Проверка по токену включается параметром `auth_enabled`; по умолчанию вход без токена, а для доступа по сети автор советует HTTPS.
• Документация в папке docs/current написана преимущественно по-китайски, основной файл на английском и китайском.
• Это плагин сообщества, к Godot Engine и Anthropic он не относится. Версия 1.0.8, лицензия MIT.
• Для Claude Desktop нужен мост `mcp-remote`, он ставится через npm.

Как отключить. В Godot откройте Project Settings, вкладку Plugins, и переключите Godot MCP Native в состояние Disable, сервер остановится. Затем удалите запись godot-mcp из настроек MCP вашего агента. Папку addons/godot_mcp из проекта можно убрать совсем.

Коротко о README

В репозитории есть плагин в папке addons/godot_mcp, исходники командной строки gdmcp с бинарниками в релизах для macOS, Linux и Windows, скилл skills/gdmcp и каталог документации с быстрым стартом, архитектурой, справочниками инструментов и CLI и руководством по тестам. Основной файл содержит примеры подключения для Claude Desktop, Cursor, Cline, OpenCode и Codex, перечень команд и рекомендации по безопасности.