Gear

Gear позволяет ИИ-ассистентам напрямую запускать, проверять, изменять и отлаживать ваши проекты на Godot.

Быстрый старт (3 минуты)

Системные требования

• Godot 4.x

• Node.js 18+

• MCP-совместимый клиент (Claude Desktop, Cursor, Cline и др.)

1) Запуск Gear

npx -y gear

Или установите глобально:

npm install -g gear-godot-mcp
gear

2) Настройка MCP-клиента

Добавьте в конфигурационный файл вашего клиента (например, Claude Desktop):

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "gear"],
      "env": {
        "GODOT_PATH": "/path/to/godot"
      }
    }
  }
}

3) Попробуйте эти команды

• "Перечисли все проекты Godot в директории /your/projects"

• "Создай scenes/Player.tscn с корневым узлом CharacterBody2D"

• "Запусти проект, получи отладочный вывод и исправь ошибки"

Related MCP server: Godot MCP Enhanced

Почему стоит использовать Gear

Ключевые преимущества

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

• ✅ Инди-разработчики, использующие ИИ для ускорения разработки

• ✅ Команды, которым нужно, чтобы ИИ понимал состояние проекта/рантайма

• ✅ Интенсивный процесс отладки (точки останова, трассировка стека, проверка рантайма)

Режимы использования инструментов

Уровни доступа к инструментам

Gear поддерживает три режима доступа:

Динамические группы в режиме compact

В режиме compact 78 дополнительных инструментов организованы в 22 динамические группы:

Как использовать группы инструментов

1. Автоматическая активация (рекомендуется)

Используйте tool.catalog для поиска нужных инструментов, соответствующие группы активируются автоматически

2. Ручная активация

Используйте tool.groups для ручной активации конкретной группы "Активируй группу dap для отладки"

3. Отключение

Используйте tool.groups для сброса активированных групп

Установка

Способ A: npx (рекомендуется)

npx -y gear

Способ B: Глобальная установка

npm install -g gear-godot-mcp
gear

Способ C: Установка из исходного кода

git clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.js

Обзор возможностей

Редактирование сцен

• Создание сцен, добавление/удаление узлов

• Изменение свойств узлов

• Изменение родительских связей узлов

Работа со скриптами

• Создание/изменение скриптов

• Анализ структуры скриптов

• Переименование символов

Отладка в рантайме

• Проверка дерева сцены в реальном времени

• Установка точек останова, пошаговое выполнение

• Просмотр значений переменных

Ввод и скриншоты

• Инъекция ввода с клавиатуры/мыши

• Захват экрана игры

• Захват области просмотра

Управление активами

• Поиск CC0-материалов (Poly Haven, AmbientCG, Kenney)

• Загрузка ресурсов в проект

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

Часто задаваемые вопросы

Ссылки

• Документация по архитектуре

• Дорожная карта платформы

• История изменений

• Руководство по внесению вклада

Лицензия

MIT — подробнее см. LICENSE.

Благодарности

• Оригинальный MCP-сервер от Coding-Solo

• Улучшения Gear разработаны HaD0Yun

• Функционал визуализации проекта вдохновлен tomyud1/godot-mcp