Godot MCP — интеграция Godot Engine с AI-ассистентами

Godot MCP — это сервер, реализующий протокол MCP (Model Context Protocol) для взаимодействия AI-ассистентов (Claude, Cline, Cursor и др.) с игровым движком Godot Engine. Он позволяет запускать редактор, выполнять проекты в режиме отладки, получать вывод консоли и управлять сценами — всё через единый интерфейс.

Возможности

• Запуск редактора Godot — открыть редактор для конкретного проекта.
• Запуск проектов — выполнить Godot-проект в режиме отладки.
• Получение отладочного вывода — перехват консольных сообщений и ошибок.
• Управление выполнением — остановка и запуск проектов программно.
• Версия Godot — получение установленной версии движка.
• Список проектов — поиск Godot-проектов в указанной директории.
• Анализ проекта — детальная информация о структуре проекта.
• Управление сценами:
  • Создание новых сцен с выбором типа корневого узла.
  • Добавление узлов в существующую сцену с настраиваемыми свойствами.
  • Загрузка спрайтов и текстур в узел Sprite2D.
  • Экспорт 3D-сцен как MeshLibrary для GridMap.
  • Сохранение сцен с возможностью создания вариантов (variants).
• Управление UID (Godot 4.4+) — получение UID для файлов и обновление ссылок UID при пересохранении ресурсов.

Требования

• Установленный Godot Engine
• Node.js и npm
• AI-ассистент с поддержкой MCP (Cline, Cursor и другие)

Установка и настройка

Шаг 1. Клонирование и сборка

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

После сборки появится каталог build/ с файлом index.js.

Шаг 2. Подключение к AI-ассистенту

Вариант A: Cline

Добавьте в конфигурационный файл MCP (путь: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/абсолютный/путь/к/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true" // опционально, включит подробное логирование
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

Вариант B: Cursor

Через интерфейс Cursor:

1. Откройте Settings > Features > MCP.
2. Нажмите + Add New MCP Server.
3. Заполните:
   • Name: godot (или любое имя)
   • Type: command
   • Command: node /абсолютный/путь/к/godot-mcp/build/index.js
4. Нажмите Add.

Либо создайте файл .cursor/mcp.json в корне проекта:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/абсолютный/путь/к/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Шаг 3. Переменные окружения (опционально)

• GODOT_PATH — путь к исполняемому файлу Godot (если не указан, сервер пытается найти автоматически).
• DEBUG — установите true для подробного логирования на стороне сервера.

Примеры запросов

После настройки AI-ассистент будет автоматически запускать MCP-сервер при необходимости. Примеры промптов:

• «Запусти редактор Godot для проекта по пути /path/to/project»
• «Запусти мой Godot-проект и покажи ошибки»
• «Получи информацию о структуре моего Godot-проекта»
• «Проанализируй структуру проекта и предложи улучшения»
• «Помоги отладить эту ошибку в Godot-проекте: [текст ошибки]»
• «Напиши GDScript для контроллера персонажа с двойным прыжком и скольжением по стенам»
• «Создай новую сцену с узлом Player в моём Godot-проекте»
• «Добавь Sprite2D в сцену игрока и загрузи текстуру персонажа»
• «Экспортируй мои 3D-модели как MeshLibrary для GridMap»
• «Создай UI-сцену с кнопками и метками для главного меню»
• «Получи UID для скрипта в проекте Godot 4.4»
• «Обнови ссылки UID в проекте после обновления до Godot 4.4»

Архитектура

Сервер использует единый GDScript-файл (godot_operations.gd) для сложных операций, а простые команды (запуск редактора, получение информации) выполняются напрямую через CLI Godot. Такой подход:

• Не создаёт временных файлов.
• Централизует логику в одном файле.
• Упрощает добавление новых операций.
• Обеспечивает единообразное сообщение об ошибках.
• Уменьшает количество операций ввода-вывода.

Скрипт принимает тип операции и параметры в JSON, что позволяет гибко выполнять действия без генерации временных файлов.

Решение проблем

• Godot не найден — установите переменную GODOT_PATH.
• Проблемы с подключением — убедитесь, что сервер запущен, перезапустите AI-ассистента.
• Неверный путь к проекту — путь должен указывать на каталог с файлом project.godot.
• Ошибки сборки — выполните npm install для установки зависимостей.
• Для Cursor:
  • MCP-сервер должен быть включён в настройках (Settings > MCP).
  • Инструменты MCP работают только в режиме Agent (требуется подписка Cursor Pro или Business).
  • Используйте «Yolo Mode» для автоматического вызова инструментов.

Лицензия

Проект распространяется под лицензией MIT. Подробнее — в файле LICENSE.