gopeak

gopeak

HaD0YunMIT
204 звёзд22 форков
GoPeak — MCP-сервер для Godot 4. Он подключает AI-ассистентов к движку и замыкает цикл разработки: написали код — запустили проект — прочитали вывод — исправили ошибки. В сервер встроено более 95 инструментов, а также Language Server Protocol (LSP) и Debug Adapter Protocol (DAP). Сервер рассчитан на разработчиков Godot, которым нужно ускорить прототипирование и отладку. AI получает доступ к API движка: читает и создаёт сцены, скрипты, анимации, управляет проектами. GoPeak использует профили инструментов — по умолчанию включён компактный набор, расширенные возможности открываются по запросу. Это экономит контекст AI и ускоряет ответы.
Gaming
Открыть на GitHub

Установка

npx -y gopeak

Характеристики

Общее

  • СтатусСообщество
  • РазработчикHaD0Yun
  • ЛицензияMIT

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Управление проектами: список, создание, просмотр информации.
  • Создание сцен: генерация .tscn файлов с любым корневым узлом.
  • Работа со скриптами: чтение, создание и редактирование GDScript.
  • Управление узлами: просмотр дерева сцены, изменение свойств.
  • Управление анимациями: создание и изменение AnimationPlayer.
  • Запуск проекта: выполнение Godot из AI и чтение debug-вывода.
  • Отладка: интеграция DAP для пошаговой отладки кода.
  • Автодополнение: LSP для анализа и подсказок в реальном времени.
  • Скриншоты: захват текущего вида сцены для контекста AI.
  • Каталог инструментов: функция tool.catalog для поиска инструментов.
  • Гибкие профили: компактный профиль и расширенные группы по запросу.

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

  1. Установите GoPeak: npx -y gopeak. Или глобально: npm install -g gopeak && gopeak.
  2. Добавьте конфигурацию в MCP-клиент. Пример для Claude Desktop: { "mcpServers": { "godot": { "command": "npx", "args": ["-y", "gopeak"], "env": { "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot", "GOPEAK_TOOL_PROFILE": "compact" } } } } Обязательно укажите путь к Godot. Профиль compact стоит по умолчанию, он не перегружает контекст AI.
  3. Перезапустите клиент. Всё готово.

Примеры запросов

  • «Покажи все проекты Godot в папке /Users/me/dev и открой Platformer.»
  • «Создай сцену Player.tscn с CharacterBody2D и скриптом для движения и прыжка.»
  • «Запусти проект, прочитай вывод консоли. Найди первую ошибку и исправь её.»
  • «Сделай скриншот сцены. Найди все Sprite2D и покажи их текстуры.»
  • «Вызови tool.catalog и активируй группу animation.»

Технические детали

  • Язык: JavaScript
  • Среда выполнения: Node.js 18 или новее
  • Движок: Godot 4.x
  • Транспорт: stdio
  • Лицензия: MIT
  • Количество инструментов: более 95
  • Дополнительно: LSP, DAP, скриншоты, каталог инструментов
  • Звёзды на GitHub: 204
  • Разработчик: HaD0Yun
  • Совместимость: Claude Desktop, Cursor, Cline, OpenCode и любые MCP-клиенты

Поделиться