Godot MCP

MCP MCP Servers Open Source

MCP-сервер для движка Godot: запускает редактор, управляет сценами, выполняет скрипты, захватывает debug-вывод и тестирует проект. AI-агент разрабатывает игры напрямую в Godot Engine.

GitHub
mcp-servers game-engine godot gamedev gdscript
Версии
v0.1.0
01.04.2025
Добавлен 06.07.2026 · Обновлён 07.07.2026 · MCP Servers
Установка 
# Требуется: Godot 4.x

# Шаг 1 — клонировать и установить зависимости:
git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install

# Шаг 2 — добавить плагин в Godot-проект:
# Скопировать папку addons/mcp_server в свой проект, включить в Project Settings → Plugins

# Claude Desktop — claude_desktop_config.json:
{ "mcpServers": { "godot": { "command": "node", "args": ["/path/to/godot-mcp/build/index.js"] } } }

# Claude Code (CLI):
claude mcp add godot -- node /path/to/godot-mcp/build/index.js

# OpenCode — ~/.config/opencode/opencode.json:
{ "mcp": { "godot": { "type": "local", "command": ["node", "/path/to/godot-mcp/build/index.js"] } } }
переведено ИИ

Godot MCP

Github-спонсоры

Сделано с Godot 

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


                          /$$      /$$  /$$$$$$  /$$$$$$$

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

Сервер контекстной модели (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
  • 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

Добавьте в файл настроек 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

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

  1. Перейдите в Настройки Cursor > Возможности > MCP
  2. Нажмите кнопку + Добавить новый сервер MCP
  3. Заполните форму:
  4. Имя: godot
  5. Тип: command
  6. Команда: npx @coding-solo/godot-mcp
  7. Нажмите «Добавить»
  8. Возможно, потребуется нажать кнопку обновления в правом верхнем углу карточки сервера MCP, чтобы загрузить список инструментов

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

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

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

Другие клиенты MCP

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

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

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

Переменная Описание
GODOT_PATH Путь к исполняемому файлу 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

Проблемы, характерные для Cursor

  • Убедитесь, что сервер MCP отображается и включен в настройках Cursor (Настройки > MCP)
  • Инструменты MCP можно запускать только с использованием профиля чата Агента (требуется подписка Cursor Pro или Business)
  • Используйте «Yolo-режим» для автоматического запуска запросов инструментов MCP

Лицензия

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

Комментарии
Войдите, чтобы оставить комментарий