GoPeak MCP
MCP-сервер для Godot 4: агент создает сцены и скрипты, запускает игру, читает ошибки и отладчик, подтягивает бесплатные ассеты
- 270 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент запускает проект Godot и скрипты и может править и удалять файлы сцен и ресурсов
- Рантайм-аддон дает инспекцию работающей игры и внедрение ввода
- Группа ассетов скачивает файлы из сети у сторонних поставщиков
Установка
- Работает в
Ручная установка
npx -y gopeakНужны Godot 4.x и Node.js 18 или новее. Для глобальной установки подойдет npm install -g gopeak.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент запускает проект Godot и скрипты и может править и удалять файлы сцен и ресурсов
- Рантайм-аддон дает инспекцию работающей игры и внедрение ввода
- Группа ассетов скачивает файлы из сети у сторонних поставщиков
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
GoPeak — MCP-сервер на TypeScript для Godot 4. Агент находит проекты, создает и правит сцены, узлы, скрипты и ресурсы, запускает игру, читает вывод отладки и сразу исправляет первую ошибку. Запускается командой `npx -y gopeak`, а в конфиге клиента достаточно указать путь к Godot в переменной `GODOT_PATH`. По умолчанию включен профиль compact: в списке остаются базовые инструменты, а остальные собраны в динамические группы, которые включаются по запросу. Через `tool.catalog` агент ищет нужное и группа включается сама, `tool.groups` включает группу вручную, а сервер сообщает клиенту, что список изменился. Группы охватывают сцены, сигналы, анимации, тайлмапы, аудио, навигацию, тему интерфейса, ввод, автозагрузки, импорт и экспорт. Профили full и legacy открывают весь список сразу, и он выдается страницами по 33 инструмента. Часть групп требует дополнений. Аддон редактора нужен для правок сцен через мост, рантайм-аддон для живой инспекции и скриншотов, LSP на порту 6005 и отладчик DAP на порту 6006 дают автодополнение GDScript, точки останова и стек вызовов. Аддоны ставит скрипт `install-addon.sh`. Отдельная группа ищет и скачивает бесплатные ассеты CC0. Автор помечает зрелость каждой группы, и часть пока имеет статус audit-required: ей нужны проверки на тестовых проектах Godot 4.
Для кого. Для разработчиков игр на Godot 4, которые хотят дать Claude Code, Cursor или Cline доступ к настоящему проекту: сценам, запуску и отладке.
Подходит, если
- Нужно создать сцену с корневым узлом CharacterBody2D и скриптом движения по текстовому описанию
- Игра падает: агент запускает проект, читает вывод и исправляет первую ошибку
- Нужна отладка с точками останова и стеком вызовов через DAP
- Нужны бесплатные ассеты CC0, которые агент найдет и подключит к проекту
- Хочется экономить токены: профиль compact не загружает сотни описаний инструментов сразу
Не подходит, если
- Вы работаете на Godot 3: сервер рассчитан на Godot 4.x
- Нужны лишь подсказки по GDScript: сервер управляет проектом и обучением не занимается
- Нужна гарантия результата для групп с пометкой audit-required: автор просит проверять их на тестовых проектах Godot 4
- В проект нельзя ставить аддоны: без них недоступны мост сцен, живая инспекция и скриншоты
Пример запроса к агенту
Создай сцену `scenes/Player.tscn` с корнем CharacterBody2D, добавь скрипт движения, запусти проект и исправь первую ошибкуMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
GODOT_PATHобязательная- Путь к исполняемому файлу Godot
GOPEAK_TOOL_PROFILE- Профиль инструментов: compact, full или legacy, по умолчанию compact
GOPEAK_TOOLS_PAGE_SIZE- Размер страницы в списке инструментов, по умолчанию 33
Ограничения
Нужны Godot 4.x и Node.js 18 или новее, путь к Godot задают переменной `GODOT_PATH`. Профиль compact включен по умолчанию, остальные инструменты открываются группами. Группы runtime, testing, lsp и dap работают, только если запущены рантайм-аддон, редактор, LSP на порту 6005 или DAP на порту 6006. Группа `asset_store` ходит в сеть к поставщикам ассетов. Многие группы автор отметил как требующие проверки, ориентируйтесь на их метки зрелости. Команда `gopeak setup` правит файлы rc для bash и zsh только если запущена явно, при установке пакета хуки не ставятся.
Как отключить. Удалите блок godot из конфига клиента и выполните `npm uninstall -g gopeak`, если ставили глобально. Плагины аддонов отключите в Project Settings, Plugins и удалите их папки из проекта.
Частые вопросы
Как подключить GoPeak к Claude Code или Cursor?
Добавьте в конфиг MCP сервер: команда npx, аргументы -y и gopeak, переменные `GODOT_PATH` и при желании `GOPEAK_TOOL_PROFILE`. Для проверки подойдут запросы: перечислить проекты в папке, создать сцену со скриптом, запустить проект и исправить верхнюю ошибку.
Чем профиль compact отличается от full?
В compact виден базовый набор инструментов, а остальные включаются группами через tool.catalog или tool.groups, поэтому токенов уходит меньше. Профили full и legacy открывают весь список сразу, и он приходит страницами по 33 инструмента, размер страницы меняет `GOPEAK_TOOLS_PAGE_SIZE`.
Нужны ли аддоны в проекте Godot?
Для базовых операций нет. Аддон `godot_mcp_editor` нужен инструментам, работающим через мост сцен и ресурсов, а рантайм-аддон нужен живой инспекции и скриншотам. Установка идет скриптом `install-addon.sh` или install-addon.ps1 в папке проекта, после чего плагины включают в Project Settings.
Как включить отладку с точками останова?
Группа dap требует отладчик Godot на порту 6006, группа lsp языковой сервер на порту 6005. Агент включает их через tool.groups и получает точки останова, шаги и стек вызовов.
Что делает команда gopeak setup?
Добавляет в rc-файлы bash и zsh хуки для уведомлений об обновлениях. Они необязательны: при установке пакета хуки не ставятся, команду запускают явно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
Аддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер для движка Godot: подключает Claude Code, Claude Desktop и Codex к работающему редактору для создания сцен, скриптов и материалов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| GoPeak (эта запись) | нет | не нужна | 270 | |
| Godot MCP Full Control | нет | не нужна | 505 | 157 инструментов для Godot 4 без динамических групп и профилей |
| Godot MCP Native | нет | не нужна | 863 | работает внутри редактора Godot и не требует Node.js |
| Godot AI | да | API-ключ | 3 271 | подключает Claude Code, Claude Desktop и Codex к работающему редактору |
Коротко о README
README открывается быстрым стартом на три минуты: требования, запуск через npx, конфиг клиента и первые запросы. Дальше объяснены профили инструментов и динамические группы с метками зрелости, постраничная выдача списка, способы установки, аддоны, возможности по областям и ссылки на документацию. Локализованные README короче английского.