Godot MCP

Форк Coding-Solo/godot-mcp, начиная с коммита 1209744 (лицензия MIT). Этот форк поддерживается независимо @jamesdowzard и добавляет поддержку валидатора экспорта для Android + другие инструменты, удобные для ИИ. Связь с исходным репозиторием на уровне git разорвана; авторские права и атрибуция сохранены в соответствии с лицензией MIT.

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Сервер протокола контекста модели (MCP) для взаимодействия с игровым движком Godot.

Введение

Godot MCP позволяет ИИ-агентам запускать редактор Godot, выполнять проекты, перехватывать отладочный вывод и управлять выполнением проектов. Этот прямой цикл обратной связи помогает агентам понимать, что работает, а что нет в реальных проектах Godot, что приводит к улучшению генерации кода и помощи в отладке.

Функции

• Запуск редактора Godot: Открытие редактора Godot для конкретного проекта

• Запуск проектов Godot: Выполнение проектов Godot в режиме отладки

• Перехват отладочного вывода: Получение вывода консоли и сообщений об ошибках

• Управление выполнением: Программный запуск и остановка проектов Godot

• Получение версии Godot: Получение версии установленного Godot

• Список проектов Godot: Поиск проектов Godot в указанной директории

• Анализ проекта: Получение подробной информации о структуре проекта

• Управление сценами:

  • Создание новых сцен с указанными типами корневых узлов

  • Добавление узлов в существующие сцены с настраиваемыми свойствами

  • Загрузка спрайтов и текстур в узлы Sprite2D

  • Экспорт 3D-сцен в качестве ресурсов MeshLibrary для GridMap

  • Сохранение сцен с опциями создания вариантов

• Управление UID (для Godot 4.4+):

  • Получение UID для конкретных файлов

  • Обновление ссылок UID путем повторного сохранения ресурсов

Требования

• Godot Engine, установленный в вашей системе

• Node.js (>=18.0.0) и npm

• ИИ-агент, поддерживающий MCP

Быстрый старт

Claude Code

claude mcp add godot -- npx @coding-solo/godot-mcp

Вот и всё. Перезапустите Claude Code, и ваши инструменты Godot MCP станут доступны.

С переменными окружения:

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

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

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "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"
      ]
    }
  }
}

Использование интерфейса Cursor:

1. Перейдите в Cursor Settings > Features > MCP

2. Нажмите кнопку + Add New MCP Server

3. Заполните форму:

   • Name: godot

   • Type: command

   • Command: npx @coding-solo/godot-mcp

4. Нажмите "Add"

5. Возможно, вам потребуется нажать кнопку обновления в правом верхнем углу карточки MCP-сервера, чтобы заполнить список инструментов

Использование конфигурации для конкретного проекта:

Создайте файл .cursor/mcp.json в директории вашего проекта:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Для любого MCP-совместимого клиента используйте эту конфигурацию:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Переменные окружения

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

Затем укажите вашему MCP-клиенту путь к build/index.js вместо использования npx.

Архитектура

Сервер Godot MCP использует подход с использованием встроенных скриптов GDScript для сложных операций:

1. Прямые команды: Простые операции, такие как запуск редактора или получение информации о проекте, используют встроенные CLI-команды Godot напрямую.

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

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

Устранение неполадок

• Godot не найден: Установите переменную окружения GODOT_PATH на путь к вашему исполняемому файлу Godot

• Проблемы с подключением: Убедитесь, что сервер запущен, и перезапустите вашего ИИ-помощника

• Неверный путь к проекту: Убедитесь, что путь указывает на директорию, содержащую файл project.godot

• Проблемы со сборкой: Убедитесь, что все зависимости установлены, выполнив npm install

• Убедитесь, что MCP-сервер отображается и включен в настройках Cursor (Settings > MCP)

• Инструменты MCP могут быть запущены только с использованием профиля чата Agent (подписка Cursor Pro или Business)

• Используйте "Yolo Mode" для автоматического выполнения запросов к инструментам MCP

Лицензия

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