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" → Установите.

Затем перейдите в Проект → Настройки проекта → Плагины и включите плагин Godot MCP.

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

Claude Desktop — Настройки → Разработчик → Изменить конфигурацию → откройте файл конфигурации и вставьте:

Mac / Linux:

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

Windows:

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

Cursor — Настройки → MCP → Добавить сервер:

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

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

Related MCP server: Godot MCP Bridge

Что он умеет?

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

Интерактивный визуализатор

Запустите map_project и получите обозреватель в браузере на localhost:6510:

• Силовой граф всех скриптов и их связей

• Нажмите на любой скрипт, чтобы увидеть переменные, функции, сигналы и соединения

• Редактируйте код прямо в визуализаторе — изменения синхронизируются с 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-пакет · Сообщить о проблемах