Godot MCP — Установка & Живое демо

Name: Godot MCP MCP Server
Author: Coding-Solo

Зачем использовать

Ключевые функции

Запуск проектов Godot 4 без дисплея со структурированным захватом stdout
Запуск редактора для конкретного проекта
Запуск отдельной сцены (--scene path.tscn) для быстрой итерации
Информация о проекте — главная сцена, версия, autoloads
Остановка запущенных процессов
Кросс-платформенность — работает везде, где работает бинарник Godot

Живое демо

Как выглядит на практике

godot-mcp-coding-solo.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "godot-mcp-coding-solo",
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "godot-mcp-coding-solo": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "godot-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add godot-mcp-coding-solo -- npx -y godot-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Godot MCP

Быстрый цикл итерации по багу в GDScript

👤 Соло / инди-разработчики ⏱ ~20 min intermediate

Когда использовать: Движение персонажа сломалось после рефакторинга; хочется, чтобы Claude исправил без ежеминутного переключения на Godot.

Предварительные требования

Установленный Godot 4 — Скачать с godotengine.org
Переменная окружения GODOT_PATH — Указать на бинарник Godot (не .app на macOS)

Поток

Контекст проекта

Godot: получи информацию о проекте /Users/me/games/Platformer. Перечисли autoloads + главную сцену.✓ Скопировано

→ Возвращены имя проекта, версия, список autoload
Запустить падающую сцену

Запусти сцену scenes/Level1.tscn без дисплея с таймаутом 10 секунд. Покажи stderr.✓ Скопировано

→ stderr захвачен; строка ошибки и трейсбек видны
Исправить и перезапустить

Ошибка: «Invalid call to method move_and_slide on null». Прочитай scripts/Player.gd, найди причину, исправь, затем перезапусти сцену.✓ Скопировано

→ Файл отредактирован, сцена перезапускается, null-ошибки нет

Итог: Баг найден и исправлен за 5 минут без выхода из чата.

Подводные камни

Запуск без дисплея зависает на модальном диалоге — Используй таймаут; проверяй stderr на заголовок диалога
GODOT_PATH указывает на неверную архитектуру (Intel vs ARM mac) — Проверяй через file $GODOT_PATH

Сочетать с: filesystem · github

Создать стейт-машину для персонажа с нуля

👤 Разработчики, начинающие новый проект ⏱ ~25 min intermediate

Когда использовать: Нужен шаблонный код стейт-машины (Idle/Run/Jump/Attack) без копипасты.

Предварительные требования

Пустой проект Godot — Создать через Project Manager

Поток

Сгенерировать файлы

Создай scripts/State.gd (базовый класс) + IdleState/RunState/JumpState/AttackState, расширяющие его. Используй сигналы для переходов. Сохрани в res://scripts/states/.✓ Скопировано

→ 5 новых .gd файлов в нужном месте
Подключить Player.gd

Обнови scripts/Player.gd для создания стейт-машины и делегирования _physics_process в current_state. Обработку ввода оставь минимальной.✓ Скопировано

→ В Player.gd есть state_machine, current_state, переходы
Smoke test

Запусти scenes/Player.tscn на 3 секунды. Ищи runtime-ошибки.✓ Скопировано

→ Чистый запуск; готово к добавлению геймплея

Итог: Рабочий шаблон стейт-машины — готов к добавлению реальных состояний.

Подводные камни

Забыл объявление class_name в State.gd — Добавь, чтобы дочерние классы могли использовать тип

Сочетать с: filesystem

Запускать gut-тесты без дисплея из CI

👤 Разработчики, настраивающие CI ⏱ ~30 min advanced

Когда использовать: Нужно запускать unit-тесты в GitHub Actions при каждом push.

Предварительные требования

Аддон Gut для тестирования — Установить через Asset Library или git submodule

Поток

Сначала запустить локально

Godot: запусти сцену addons/gut/gui/GutRunner.tscn без дисплея. Захвати exit code.✓ Скопировано

→ Тесты выполнены; exit code 0 при успехе
Сгенерировать workflow

Теперь напиши .github/workflows/test.yml, который делает то же самое на Ubuntu с godot-headless 4.x.✓ Скопировано

→ Файл workflow с правильным action для настройки Godot

Итог: Воспроизводимый CI для тестов Godot.

Подводные камни

Headless-режим падает на вызовах display — Используй --headless и избегай OS.window_* в тестах

Сочетать с: github

Комбинации

Сочетайте с другими MCP — эффект x10

godot-mcp-coding-solo + filesystem

Редактировать GDScript и перезапускать сцену в быстром цикле

Filesystem: добавь кулдаун прыжка в scripts/Player.gd. Godot: запусти scenes/Player.tscn на 3 секунды. Покажи stderr.✓ Скопировано

godot-mcp-coding-solo + github

Открыть PR после того как Claude исправил игровой баг

Godot: подтверди исправление перезапуском сцены. GitHub: открой PR с фиксом и соответствующим фрагментом лога.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
get_project_info	project_path: str	Первый вызов, проверка работоспособности	бесплатно
launch_editor	project_path: str	Открыть UI Godot	бесплатно
run_project	project_path, headless?: bool, timeout?: int	Smoke test всего проекта	бесплатно
run_scene	project_path, scene_path, headless?, timeout?	Итерация по отдельной сцене	бесплатно
stop_process	pid: int	Завершить зависший запуск	бесплатно

Стоимость и лимиты

Во что обходится

Квота API: Нет — локально
Токенов на вызов: 200–8000 (stdout/stderr могут быть большими)
Деньги: Бесплатный OSS; Godot бесплатный
Совет: Активно используй таймаут в run_scene; не давай бесконечным циклам поедать токены

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: запуск бинарника Godot

Хранение учётных данных: Нет

Исходящий трафик: Только локально

Никогда не давайте: произвольная оболочка

run_project выполнит любой GDScript в проекте — указывай только на доверенные проекты

Устранение неполадок

Частые ошибки и исправления

GODOT_PATH не найден

Укажи абсолютный путь к бинарнику Godot; на Mac используй бинарник внутри .app

Проверить: $GODOT_PATH --version

Запуск без дисплея зависает

Всегда передавай таймаут; проверяй stderr на модальный диалог или компиляцию шейдеров

Неверная версия Godot

MCP работает только с Godot 4.x; сцены 3.x не загрузятся

Проверить: godot --version

Альтернативы

Godot MCP в сравнении

Альтернатива	Когда использовать	Компромисс
godot.unitynoid (mcp-godot)	Хочешь другой форк	Менее проверенный
Bevy / Rapier MCPs	Используешь Rust/Bevy	Совершенно другой движок

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills