godot-mcp · sandraschi — MCP-сервер для Claude Code: что делает и как установить
Сервер для управления движком Godot 4 через протокол MCP. Помогает генерировать логику на GDScript, редактировать сцены и проводить детерминированное тестирование кадр за кадром.
Открыть на GitHubЧто делает godot-mcp
Сервер связывает ассистента с движком Godot 4 через сетевой мост. Он даёт ИИ доступ к узлам сцен, импорту 3D-моделей STL, GLB и OBJ, а также правке тайлмапов в обход сериализации. Для сборки проектов предусмотрен цикл Game Builder: модель пишет код на GDScript, валидирует его через gdlint и флаг движка --check-only, после чего автоматически исправляет синтаксис.
Встроено детерминированное тестирование. Игра ставится на паузу, после чего агент симулирует ввод геймпада или мыши и шагает покадрово до нужного условия. Состояние сцены читается в JSON через вызов _mcp_state(). Встроенный профайлер замеряет 14 метрик производительности и ловит всплески нагрузки.
Для запуска серверу требуются Godot 4.4+, Python 3.13, Bun и пакетный менеджер uv. Без локального Godot мост работать не сможет. Дополнительно можно подключить Ollama с моделью gemma4:12b для генерации диалогов и игровой логики без внешних API.
Какие задачи решает
- управлять узлами сцен и тайлмапами в Godot 4 через сетевой мост
- запускать покадровое тестирование с эмуляцией ввода геймпада и мыши
- генерировать логику на GDScript с автоматической проверкой через
gdlint - импортировать 3D-модели форматов OBJ, STL, GLB и облака точек Gaussian Splat
- профилировать производительность игры по 14 метрикам движка
Примеры запросов агенту
- Сделай процедурную текстуру шахматной доски через
godot_generate_procedural_textureдля нового материала. - Запусти покадровый тест игры с эмуляцией кликов мыши и проверь состояние узлов через
godot_state_digest. - Собери прототип 2D-раннера через
just gb-demoи исправь ошибки в сгенерированном GDScript.
Как установить godot-mcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о godot-mcp
Как установить и запустить godot-mcp для Claude Code?
Склонируйте репозиторий командой git clone https://github.com/sandraschi/godot-mcp, перейдите в папку cd godot-mcp, установите окружение just bootstrap и запустите процесс через just serve.
Что делает godot-mcp?
Он предоставляет набор инструментов для контроля запущенного редактора Godot 4, автоматического создания GDScript, пошаговой симуляции геймплея и отслеживания метрик производительности.
Какие требования нужны для работы godot-mcp?
Понадобятся установленный Godot 4.4 или новее, Python 3.13 с утилитой uv и среда bun. Подключение Ollama с моделью gemma4:12b требуется только для локальной генерации логики.
Похожие MCP-серверы
Всё по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →Сначала — godot-mcp от других авторов.
