Godot MCP

Дайте своему ИИ-ассистенту полный доступ к редактору Godot.

Создавайте игры быстрее с помощью Claude, Cursor или любого ИИ, совместимого с MCP — без копирования и вставки, без переключения контекста. ИИ напрямую читает, записывает и изменяет ваши сцены, скрипты, узлы и настройки проекта.

Godot 4.x · 42 инструмента · Интерактивная визуализация проекта · Лицензия MIT

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

0. Установите Node.js (однократная настройка)

Загрузите и запустите установщик с nodejs.org (версия LTS). Это стандартный установщик — терминал не требуется.

1. Установите плагин Godot

Внутри редактора Godot нажмите вкладку AssetLib вверху → найдите "mcp" → найдите "Godot AI Assistant tools MCP" → Установить.

Затем перейдите в Project → Project Settings → Plugins и активируйте плагин Godot MCP.

2. Добавьте конфигурацию сервера в свой ИИ-клиент

Claude Desktop — Settings → Developer → Edit Config → откройте конфигурационный файл и вставьте:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Settings → MCP → Add Server:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — выполните в терминале:

claude mcp add godot -- npx -y godot-mcp-server

Работает с любым клиентом, совместимым с MCP (Cline, Windsurf и т.д.)

3. Перезапустите свой ИИ-клиент

Закройте и снова откройте Claude Desktop / Cursor / свой клиент, чтобы он применил новую конфигурацию.

4. Перезапустите свой проект Godot

Нажмите Restart Project в редакторе Godot. Проверьте правый верхний угол — вы должны увидеть MCP Connected зеленым цветом. Всё готово.

Что это умеет делать?

42 инструмента в 6 категориях

Интерактивная визуализация

Выполните map_project и получите исследователь проекта в браузере по адресу localhost:6510: - Граф всех скриптов и их взаимосвязей (force-directed graph) - Нажмите на любой скрипт, чтобы увидеть переменные, функции, сигналы и связи - Редактируйте код напрямую в визуализаторе — изменения синхронизируются с Godot в реальном времени - Просмотр сцены с редактированием свойств узлов - Поиск использований перед рефакторингом

Ограничения

ИИ не может создать 100% игры самостоятельно — ему трудно с сложными макетами UI, компоновкой сцен и некоторыми манипуляциями со свойствами узлов. Проект всё ещё активно разрабатывается, поэтому отзывы очень приветствуются!

Архитектура

┌─────────────┐    MCP (stdio)   ┌──────────────┐   WebSocket   ┌──────────────┐
│  AI Client  │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,   │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)   │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  42 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser    │
                                 │  Visualizer  │
                                 └──────────────┘

Текущие ограничения

• Только локально — работает на localhost, без удаленных подключений
• Одно подключение — одновременно только один экземпляр Godot
• Нет отмены — изменения сохраняются сразу (используйте систему контроля версий)
• ИИ всё ещё ограничен в знаниях о Godot — он не может создать 100% игры в одиночку, но может помочь с отладкой, написанием скриптов и сопровождать вас в процессе разработки

Разработка

Чтобы собрать из исходного кода вместо использования npm:

cd mcp-server
npm install
npm run build

Затем укажите своему ИИ-клиенту путь к mcp-server/dist/index.js вместо использования npx.

Примечания к выпуску

Подробные описания каждого выпуска находятся в release-notes/ (начиная с v0.5.0). Полную историю изменений смотрите в CHANGELOG.md.

Лицензия

MIT

npm-пакет · Сообщить о проблемах