# godot-mcp

Сервер для управления движком Godot 4 через протокол MCP. Помогает генерировать логику на GDScript, редактировать сцены и проводить детерминированное тестирование кадр за кадром.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 6
- Автор: sandraschi
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sandraschi/godot-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/sandraschi-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.

## Требования
- Нужно: Python и uv (команды через uvx)
- Работает с: Godot

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- управлять узлами сцен и тайлмапами в Godot 4 через сетевой мост
- запускать покадровое тестирование с эмуляцией ввода геймпада и мыши
- генерировать логику на GDScript с автоматической проверкой через `gdlint`
- импортировать 3D-модели форматов OBJ, STL, GLB и облака точек Gaussian Splat
- профилировать производительность игры по 14 метрикам движка

## Примеры запросов агенту
- Сделай процедурную текстуру шахматной доски через `godot_generate_procedural_texture` для нового материала.
- Запусти покадровый тест игры с эмуляцией кликов мыши и проверь состояние узлов через `godot_state_digest`.
- Собери прототип 2D-раннера через `just gb-demo` и исправь ошибки в сгенерированном GDScript.

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25137
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4534
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 982
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 732

## Другие версии с тем же именем
- [godot-mcp · tomyud1](https://affpapa.org/nevibecode/mcp/tomyud1-godot-mcp.md) — ★ 445

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md