Godot MCP

MCP сервер, который позволяет AI-ассистентам взаимодействовать с игровым движком Godot, предоставляя возможности для запуска редактора, выполнения проектов, захвата отладочного вывода и управления сценами через стандартизированный интерфейс.

Установка

Из исходного кода

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

Конфигурация

Cline

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/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"
      ]
    }
  }
}

Cursor Project-Specific

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Доступные инструменты

Инструмент	Описание
`launch_editor`	Запуск редактора Godot для конкретного проекта
`run_project`	Выполнение проектов Godot в режиме отладки
`get_debug_output`	Получение вывода консоли и сообщений об ошибках
`stop_project`	Остановка выполняющихся проектов Godot
`get_godot_version`	Получение версии установленного Godot
`list_projects`	Поиск проектов Godot в указанной директории
`get_project_info`	Получение подробной информации о структуре проекта
`create_scene`	Создание новых сцен с указанными типами корневых узлов
`add_node`	Добавление узлов в существующие сцены с настраиваемыми свойствами
`load_sprite`	Загрузка спрайтов и текстур в узлы Sprite2D
`export_mesh_library`	Экспорт 3D сцен как ресурсы MeshLibrary для GridMap
`save_scene`	Сохранение сцен с опциями создания вариантов
`get_uid`	Получение UID для конкретных файлов (Godot 4.4+)
`update_project_uids`	Обновление UID-ссылок путем пересохранения ресурсов (Godot 4.4+)

Возможности

Запуск редактора Godot для конкретных проектов
Выполнение проектов Godot в режиме отладки и захват вывода
Программное управление выполнением проектов
Анализ проектов и информация о структуре
Управление сценами с созданием и модификацией узлов
Загрузка спрайтов и текстур для 2D узлов
Экспорт 3D сцен как ресурсы MeshLibrary
Управление UID для проектов Godot 4.4+
Прямая обратная связь для генерации кода AI и отладки

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

Опциональные

GODOT_PATH - Путь к исполняемому файлу Godot (переопределяет автоматическое обнаружение)
DEBUG - Установите в "true" для включения детального логирования на стороне сервера

Примеры использования

Запусти редактор Godot для моего проекта в /path/to/project

Запусти мой проект Godot и покажи любые ошибки

Получи информацию о структуре моего проекта Godot

Проанализируй структуру моего проекта Godot и предложи улучшения

Помоги мне отладить эту ошибку в моем проекте Godot: [вставить ошибку]

Ресурсы

GitHub Repository

Примечания

Требует установки Godot Engine в вашей системе. Использует встроенный подход GDScript для сложных операций, исключая временные файлы и обеспечивая лучшую поддерживаемость. Для пользователей Cursor инструменты MCP могут запускаться только с использованием профиля чата Agent (требуется подписка Cursor Pro или Business).

Installation

Description