Об этом проекте

Godot MCP — это сервер Model Context Protocol (MCP), который связывает ИИ-агентов с игровым движком Godot. Он позволяет ИИ-ассистентам напрямую взаимодействовать с проектами Godot: запускать редактор, выполнять проекты в режиме отладки, перехватывать вывод консоли и управлять потоком выполнения. Сервер также предоставляет возможности управления сценами, включая создание сцен, добавление узлов с пользовательскими свойствами, загрузку спрайтов, экспорт 3D-сцен как ресурсов MeshLibrary и управление ссылками UID для Godot 4.4+. ## Ключевые возможности - **Управление редактором и проектами**: запуск редактора Godot, выполнение проектов в режиме отладки и их программная остановка - **Перехват отладочного вывода**: получение вывода консоли и сообщений об ошибках для обратной связи в реальном времени - **Анализ проектов**: список проектов в каталоге, получение подробной информации о структуре проекта и установленной версии Godot - **Управление сценами**: - Создание новых сцен с указанными типами корневых узлов - Добавление узлов в существующие сцены с настраиваемыми свойствами - Загрузка спрайтов/текстур в узлы Sprite2D - Экспорт 3D-сцен как ресурсов MeshLibrary для GridMap - Сохранение сцен с различными вариантами - **Управление UID** (Godot 4.4+): получение UID для файлов и обновление ссылок UID путем повторного сохранения ресурсов ## Архитектура Сервер использует гибридный подход: 1. **Прямые команды**: простые операции (запуск редактора, получение версии) используют встроенные команды CLI Godot 2. **Встроенный скрипт операций**: сложные операции (создание сцен, манипуляции с узлами) используют единый комплексный файл GDScript (`godot_operations.gd`), который принимает тип операции и параметры в формате JSON, что обеспечивает гибкое выполнение без создания временных файлов ## Требования - Установленный Godot Engine - Node.js (>=18.0.0) и npm - MCP-совместимый ИИ-агент (например, Claude Code, Cursor) ## Быстрый старт Для Claude Code: ```bash claude mcp add godot -- npx @coding-solo/godot-mcp ``` Для Cursor добавьте MCP-сервер в настройках с командой `npx @coding-solo/godot-mcp`. ## Конфигурация Переменные окружения: - `GODOT_PATH`: путь к исполняемому файлу Godot (переопределяет автоматическое обнаружение) - `DEBUG`: установите `"true"` для подробного логирования на стороне сервера ## Устранение неполадок - **Godot не найден**: установите переменную окружения `GODOT_PATH` - **Проблемы с подключением**: убедитесь, что сервер запущен, и перезапустите ИИ-ассистента - **Неверный путь к проекту**: убедитесь, что путь содержит файл `project.godot` - **Проблемы со сборкой**: выполните `npm install` для установки зависимостей ## Лицензия Лицензия MIT