Godot MCP

hi-godot/godot-ai· Проверено 12.11.2026· 3,5 тыс.на GitHub

Даёт агенту работать с проектом Godot: запускать игру и читать ошибки, создавать сцены и узлы, править скрипты. Один сервер ходит через командную строку Godot, второй подключается к открытому редактору через аддон.

2 реализации:

Аддон в живом редакторе Godot 4.7+: 46 инструментов для сцен, узлов, сигналов, UI, материалов, анимации, частиц и тестов; док сам прописывает клиенты.

Как подключить

Что сделать до подключения

Godot 4.7 или новее и менеджер пакетов uv

Поставить аддон из вкладки AssetLib в Godot или из релиза на GitHub в папку addons/godot_ai/ проекта

Включить его: Project → Project Settings → Plugins → Godot AI

В доке Godot AI нажать Configure напротив своего клиента или Configure all; точная команда для ручной настройки — в пункте Run this manually

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio godot \
  -- uvx --isolated --no-config --from 'godot-ai==<версия аддона>' godot-ai attach --port 8000 --ws-port 9500

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.godot]
command = "uvx"
args = ["--isolated", "--no-config", "--from", "godot-ai==<версия аддона>", "godot-ai", "attach", "--port", "8000", "--ws-port", "9500"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "godot": {
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "godot": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "godot": {
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "godot": {
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "godot": {
        "type": "local",
        "command": [
          "uvx",
          "--isolated",
          "--no-config",
          "--from",
          "godot-ai==<версия аддона>",
          "godot-ai",
          "attach",
          "--port",
          "8000",
          "--ws-port",
          "9500"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "godot": {
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "godot": {
      "command": "uvx",
      "args": [
        "--isolated",
        "--no-config",
        "--from",
        "godot-ai==<версия аддона>",
        "godot-ai",
        "attach",
        "--port",
        "8000",
        "--ws-port",
        "9500"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

editor_stateпоказывает состояние редактора и игры

scene_get_hierarchyчитает дерево сцены

node_get_propertiesчитает свойства узла

node_createсоздаёт узел

node_set_propertyменяет свойство узла

node_findищет узлы

scene_openоткрывает сцену

scene_saveсохраняет сцену

script_createсоздаёт скрипт

script_patchправит скрипт по якорю

script_attachприкрепляет скрипт к узлу

project_runзапускает проект

test_runзапускает тесты GDScript

logs_readчитает логи редактора и игры

editor_screenshotснимает вьюпорт или кадр игры

animation_createсоздаёт анимацию

batch_executeвыполняет команды пачкой с откатом

signal_manageподключает и отключает сигналы

material_manageсоздаёт и назначает материалы

ui_manageсобирает интерфейс

Показано 20 из 46.

Без аддона: запускает редактор и проект через командную строку Godot и читает отладочный вывод, сцены правит через встроенный GDScript; 14 инструментов.

Как подключить

Что сделать до подключения

Установленный Godot

Node.js 18 или новее и npm

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GODOT_PATH=<путь к исполняемому файлу Godot>' --transport stdio godot-mcp \
  -- npx @coding-solo/godot-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.godot-mcp]
command = "npx"
args = ["@coding-solo/godot-mcp"]

[mcp_servers.godot-mcp.env]
GODOT_PATH = "<путь к исполняемому файлу Godot>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "godot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "godot-mcp": {
        "type": "local",
        "command": ["npx", "@coding-solo/godot-mcp"],
        "environment": {
          "GODOT_PATH": "<путь к исполняемому файлу Godot>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "<путь к исполняемому файлу Godot>"
      }
    }
  }
}

Инструменты сервера

launch_editorоткрывает редактор для проекта

run_projectзапускает проект в режиме отладки

get_debug_outputчитает вывод и ошибки

stop_projectостанавливает проект

get_godot_versionпоказывает версию Godot

list_projectsищет проекты в папке

get_project_infoописывает структуру проекта

create_sceneсоздаёт сцену

add_nodeдобавляет узел в сцену

load_spriteзагружает текстуру в Sprite2D

export_mesh_libraryэкспортирует MeshLibrary для GridMap

save_sceneсохраняет сцену

get_uidпоказывает UID файла

update_project_uidsобновляет ссылки UID

Что попросить агента

«Покажи иерархию текущей сцены»Godot AI выведет дерево узлов через scene_get_hierarchy

«Создай Camera3D с именем MainCamera под /Main»Godot AI добавит узел через node_create и выставит свойства через node_set_property

«Запусти тесты сцены»Godot AI вызовет test_run и прочитает вывод через logs_read

«Сделай воксельную игру: игрок, блоки, которые можно ставить и ломать, и слоты сохранения»Godot AI создаст сцены и скрипты через node_create, script_create и script_attach, запустит проект через project_run и проверит результат через editor_screenshot

«Запусти проект <путь к проекту> и скажи, какие ошибки пишет отладчик»Godot MCP запустит игру через run_project, прочитает вывод через get_debug_output и остановит её через stop_project

Для каких задач

Показать дерево текущей сцены и свойства узлов

Добавить в сцену камеру Camera3D с нужным именем

Запустить проект, собрать ошибки из вывода и поправить скрипт

Прогнать тесты сцены

Собрать прототип игры по нескольким запросам, например воксельный мир с сохранениями

Ограничения

Godot AI требует Godot 4.7 или новее; C# он только пишет текстом, без сборки .NET и без ошибок компилятора

Для Godot AI нужна команда из дока: она содержит версию аддона и порты, а голый адрес http://127.0.0.1:8000/mcp не проходит авторизацию

Godot MCP не видит открытый редактор: он запускает Godot из командной строки, а функции UID работают только с Godot 4.4+

Godot AI отправляет анонимную статистику без кода и имён файлов; отключается переменной GODOT_AI_DISABLE_TELEMETRY=true

Если не работает

Godot MCP: Godot не найден

Укажите путь к исполняемому файлу Godot в переменной GODOT_PATH.

Godot MCP: Invalid Project Path

Путь должен вести в папку, где лежит project.godot.

Godot AI: «Port 8000 is occupied by an incompatible server»

Порт занят другой программой: выберите в панели плагина свободные HTTP- и WebSocket-порты, нажмите Apply + Reload и заново настройте клиенты через Configure.

Godot AI на Bazzite или Fedora Atomic завершается с Last pending: capability_record

В 4.0.2 и раньше сервер не принимает путь через ссылку /home → /var/home: обновитесь до 4.0.3 или новее.

Godot AI на Linux не стартует из-за прав на папки

Если у папок на пути к данным плагина есть запись для группы или всех (775, 777), уберите её командой chmod go-w для конкретной папки, без рекурсии.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Godot AI	hi-godot	3,5 тыс.	локально	не нужен	46	11 ноября 2026
Godot MCP	Coding-Solo	6,6 тыс.	локально	не нужен	14	16 апреля 2026

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

Какой сервер выбрать?

Godot AI подключается к открытому редактору и умеет почти всё: узлы, сигналы, UI, материалы, анимацию, тесты. Godot MCP проще: ставится одной командой npx, запускает проект и отдаёт агенту отладочный вывод.

Godot MCP не находит Godot. Что делать?

Укажите путь к исполняемому файлу в переменной GODOT_PATH: она заменяет автоматический поиск. Путь к проекту должен вести в папку, где лежит project.godot.

Можно писать на C#?

В Godot AI скрипты .cs создаются и правятся как текст, а script_manage показывает их структуру. Собирать .NET и показывать ошибки компилятора сервер не умеет; чтобы прикрепить .cs, нужна сборка редактора с .NET.

Godot AI безопасен?

Сервер и редактор принимают только соединения с меняющимися ключами, связь с редактором идёт только через localhost. Запись разрешена только внутри проекта, а project.godot, override.cfg и .godot/ закрыты.

Работает ли сервер из России?

Оба сервера работают на вашем компьютере, ключи и зарубежные аккаунты не нужны.

Godot MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

Похожие серверы