Godot MCP

Что такое Godot MCP?

Godot MCP — это плагин для Godot Engine, который служит мостом между вашими проектами Godot и ИИ-помощниками, используя стандартный протокол Model Context. Он позволяет ИИ-инструментам получать доступ, анализировать и изменять скрипты, сцены, узлы и настройки проекта напрямую, что открывает новые потоки работы, основанные на ИИ, для разработки, отладки и совместного творчества.

Как настроить Godot MCP

• Склонируйте репозиторий godot-mcp и перейдите в его директорию.
• Постройте и настройте сервер MCP, запустив npm install и npm run build в директории /server.
• Отредактируйте файл конфигурации Claude Desktop (например, claude_desktop_config.json), чтобы добавить запись о сервере MCP, указывающую на файл запуска вашего собранного сервера.
• Убедитесь, что вы заменили PATH_TO_YOUR_PROJECT на абсолютный путь к вашему клонированному репозиторию.
• Перезапустите Claude Desktop, чтобы применить изменения.
• В Godot откройте предоставленный пример проекта или добавьте папку addons/godot_mcp в директорию дополнений вашего проекта.
• Включите плагин в Project > Project Settings > Plugins в редакторе Godot.

Как использовать Godot MCP

При запущенном сервере MCP и включенном плагине взаимодействуйте с вашим проектом Godot через интерфейс ИИ-помощника (например, Claude Desktop), используя структурированные или естественные языковые команды. Начинайте команды с @mcp godot-mcp, чтобы отправить запросы через сервер MCP. Вы можете запрашивать предложения по коду, изменения сцен, контент, созданный ИИ, и выполнять команды проекта или ресурсов напрямую.

Примеры команд

• @mcp godot-mcp read godot://script/current
  "Мне нужна помощь в оптимизации кода движения игрока. Можешь предложить улучшения?"
• @mcp godot-mcp run get-scene-tree
  "Добавь куб в середину сцены, а затем создай камеру, смотрящую на куб."
• @mcp godot-mcp read godot://scene/current
  "Создай ИИ противника, который патрулирует между контрольными точками и атакует игрока, когда он в пределах досягаемости."

Ключевые возможности

• Бесшовная двусторонняя связь между Godot и ИИ-помощниками
• Программный доступ и изменение ресурсов проекта, скриптов, сцен и узлов
• Обширный набор команд для управления узлами, редактирования скриптов, контроля сцен и проектов
• Легкое расширение дополнительными ЭПУ MCP
• Безопасная локальная или удаленная настройка с поддержкой интеграции через Claude Desktop
• Поддержка естественного языка для помощи при кодировании, отладке и создании сцен

Сценарии использования

• Код-ревью, генерация и рефакторинг на основе ИИ для файлов GDScript
• Автоматическое создание сцен, управление узлами и процедурная генерация окружения
• Анализ проектов для оптимизации производительности или обнаружения ошибок
• Реализация логики игрового процесса, поведения ИИ и элементов интерфейса через предложения ИИ
• Пакетное редактирование или создание ресурсов и настроек с помощью рекомендаций ИИ
• Ускорение прототипирования, обучения или совместной разработки в проектах Godot

ЧАВО

В: Плагин не работает или не отображается в Godot. Что мне делать?
О: Убедитесь, что вы включили плагин "Godot MCP" в Project > Project Settings > Plugins. Если вы недавно скопировали дополнение или вносили изменения в конфигурацию, попробуйте перезагрузить проект и проверьте наличие сообщений об ошибках в консоли Godot.

В: Claude Desktop не может подключиться к серверу MCP. В чем причина?
О: Проверьте, что сервер успешно запущен (без ошибок при старте) и что конфигурация Claude Desktop содержит правильный абсолютный путь. Убедитесь, что MCP_TRANSPORT установлен на stdio. Перезапустите Claude Desktop после обновления конфигурации.

В: Могу ли я использовать Godot MCP с имеющимися проектами или только с включенным примером?
О: Да, вы можете использовать его с любым проектом Godot. Просто скопируйте папку addons/godot_mcp в директорию дополнений вашего проекта и включите плагин в настройках.

В: Что если я хочу расширить Godot MCP или добавить пользовательские команды?
О: Плагин и сервер являются открытым исходным кодом и предназначены для расширяемости. Вы можете реализовать новые концевые точки в сервере MCP или расширить дополнение Godot для предоставления дополнительной функциональности.

В: Безопасны ли данные моего проекта при использовании Godot MCP?
О: Да, по умолчанию сервер MCP работает на вашем локальном компьютере и получает доступ к файлам и данным только с вашего разрешения. Проверьте конфигурации сервера и всегда учитывайте рекомендации по безопасности данных.