Godot MCP Pro

168 инструментов на базе ИИ для редактора Godot 4 — подключите своего ИИ-ассистента (Claude, Cursor, Cline, Copilot) к Godot и создавайте игры с помощью естественного языка.

Как это работает

Подключите своего ИИ-ассистента к Godot менее чем за 5 минут.

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

Скопируйте addons/godot_mcp/ в ваш проект Godot. Включите его в разделе Project > Project Settings > Plugins. Плагин автоматически запустит WebSocket-сервер внутри редактора.

2. Соберите MCP-сервер

cd server
npm install && npm run build

Это скомпилирует TypeScript MCP-сервер, который связывает ваш ИИ-клиент с плагином Godot.

3. Начните разработку с ИИ

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

Конфигурация MCP-клиента

Claude Code / Claude Desktop

Добавьте в .claude/mcp.json:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/server/dist/index.js"]
    }
  }
}

VS Code / Cursor

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "godot": {
      "command": "node",
      "args": ["./server/dist/index.js"]
    }
  }
}

Любой stdio MCP-клиент

node server/dist/index.js

Сервер обменивается данными через stdio (stdin/stdout) с использованием протокола MCP.

Автоматизированная настройка (рекомендуется)

cd server
npm run run

Это автоматически выполнит следующие действия:

Сборка MCP-сервера
Поиск project.godot в родительских папках (или GODOT_PROJECT_PATH)
Синхронизация аддона в addons/godot_mcp
Включение плагина в project.godot
Создание файлов конфигурации MCP
Синхронизация файлов контекста ИИ

Категории инструментов

#	Категория	Инструменты	Основное
1	Проект	7	Чтение/запись настроек, преобразование UID
2	Сцена	9	Создание, открытие, запуск, остановка, инстанцирование, сохранение
3	Узел	14	Добавление/удаление/переименование/перемещение с UndoRedo, сигналы, группы
4	Скрипт	8	CRUD, привязка, проверка, поиск по номерам строк
5	Редактор	10	Скриншоты, выполнение GDScript, журнал ошибок, перезагрузка
6	Ввод	7	Клавиатура, мышь, симуляция действий, последовательности
7	Runtime	19	Инспекция игры, захват кадров, запись/воспроизведение, UI
8	Анимация	6	CRUD, треки, ключевые кадры
9	AnimationTree	8	Конечный автомат, переходы, дерево смешивания
10	TileMap	6	Операции с ячейками (TileMapLayer для Godot 4.3+)
11	3D-сцена	6	Примитивы мешей, импорт .glb, пресеты освещения, PBR
12	Физика	6	Автоматические 2D/3D коллизии, raycasts, слои
13	Частицы	5	GPU-частицы + пресеты огня/дыма/дождя/снега/искр
14	Навигация	6	Регион, агент, запекание, поиск пути
15	Аудио	6	Плеер (авто 2D/3D), цепочка эффектов шины
16	Тема/UI	6	StyleBoxFlat, переопределение цвета/констант/шрифтов
17	Шейдер	6	Шаблоны (canvas_item, spatial, particles, sky)
18	Ресурс	6	CRUD .tres, управление автозагрузкой
19	Пакетная обработка	8	Поиск по типу, массовая установка, анализ зависимостей
20	Тестирование	6	Автоматизированные сценарии, утверждения, стресс-тестирование
21	Анализ	4	Сложность сцены, поток сигналов, неиспользуемые ресурсы
22	Профилирование	2	Мониторы FPS, памяти, физики, рендеринга
23	Экспорт	3	Список пресетов, команды сборки
	Всего	168	+ 4 основных инструмента подключения

Ключевые особенности

🧠 Умный парсинг типов

Нет необходимости вручную создавать сложные объекты. Значения свойств конвертируются автоматически:

"Vector2(100, 200)"  → Vector2(100, 200)
"Color(1, 0, 0)"    → Color(1, 0, 0)
"#ff0000"            → Color(1, 0, 0)
"Color.RED"          → Color(1, 0, 0)
"true"               → true
"42"                 → 42

♻️ Отмена/повтор всех изменений

Каждое действие add_node, delete_node, update_property, rename_node и move_node проходит через систему UndoRedo в Godot. Пользователи могут нажать Ctrl+Z для отмены любого действия ИИ.

🎯 Автоматическое определение 2D/3D

Физические тела, формы коллизий, аудио-плееры, частицы и узлы навигации автоматически определяют, является ли родитель 2D или 3D — нужный тип создается каждый раз.

🔥 Встроенные пресеты

Освещение: солнце, интерьер, драматическое, прожектор
Частицы: огонь, дым, дождь, снег, искры
Шейдеры: шаблоны canvas_item, spatial, particles, sky
Аудиоэффекты: реверберация, задержка, компрессор, эквалайзер, дисторшн, хорус, фейзер

Краткий пример

AI: godot_connect
AI: create_scene path="res://scenes/level.tscn" rootType="Node2D"
AI: add_node type="CharacterBody2D" name="Player" parentPath="."
AI: add_node type="Sprite2D" name="Sprite" parentPath="Player"
AI: update_property path="Player/Sprite" property="texture" value="res://icon.svg"
AI: setup_collision path="Player" shapeType="rectangle" size="Vector2(32, 32)"
AI: create_script path="res://scripts/player.gd" content="extends CharacterBody2D..."
AI: attach_script nodePath="Player" scriptPath="res://scripts/player.gd"
AI: save_scene
AI: play_scene
AI: simulate_key key="Space"
AI: get_game_screenshot
AI: stop_scene

Архитектура

server/src/
├── index.ts           TypeScript MCP server (stdio transport)
├── toolCatalog.ts     168 tool definitions with input schemas
└── godotBridge.ts     WebSocket client → Godot editor

addons/godot_mcp/
├── plugin.gd          Plugin entry point
├── websocket_server.gd Local WebSocket server (port 6505)
├── command_router.gd  Loads 20 handler modules, dispatches commands
└── commands/
    ├── base_commands.gd        Shared utilities (type parser, undo, I/O)
    ├── type_parser.gd          Smart string→Godot type conversion
    ├── undo_helper.gd          UndoRedo wrapper
    ├── core_commands.gd        Project, scene, node, script, editor (47 handlers)
    ├── editor_commands.gd      Screenshots, execute script (4)
    ├── input_commands.gd       Input simulation (7)
    ├── runtime_commands.gd     Game inspection & UI (15)
    ├── animation_commands.gd   Animation CRUD (6)
    ├── animation_tree_commands.gd  State machine & blend tree (8)
    ├── tilemap_commands.gd     Tile operations (6)
    ├── scene3d_commands.gd     3D scene building (6)
    ├── physics_commands.gd     Physics & collision (6)
    ├── particles_commands.gd   GPU particles + presets (5)
    ├── navigation_commands.gd  Nav regions & pathfinding (6)
    ├── audio_commands.gd       Audio players & bus effects (6)
    ├── theme_commands.gd       Theme & UI styling (6)
    ├── shader_commands.gd      Shader management (4)
    ├── resource_commands.gd    Resource & autoload (6)
    ├── batch_commands.gd       Batch operations (8)
    ├── testing_commands.gd     Testing & QA (5)
    ├── analysis_commands.gd    Code analysis (4)
    ├── profiling_commands.gd   Performance profiling (2)
    └── export_commands.gd      Export management (3)

Протокол моста

JSON-RPC 2.0 через WebSocket (ws://127.0.0.1:6505):

→ { "jsonrpc": "2.0", "id": 1, "method": "add_node", "params": { "type": "Sprite2D", "name": "Player" } }
← { "jsonrpc": "2.0", "id": 1, "result": { "tool": "add_node", "data": { "path": "/root/Main/Player" } } }

Переопределение URL моста: GODOT_WS_URL=ws://127.0.0.1:6505 node server/dist/index.js

Требования

Godot 4.2+ (4.3+ рекомендуется для TileMapLayer)
Node.js 18+
Любой MCP-совместимый ИИ-клиент

Файлы контекста ИИ-агента

При развертывании в проекте Godot эти файлы контекста помогают ИИ-ассистентам понять доступные инструменты:

Файл	Назначение	Используется
`addons/godot_mcp/skills.md`	Полный справочник из 168 инструментов с рабочими процессами	Все ИИ-агенты
`AGENTS.md`	Архитектура + сводка возможностей	Codex, Gemini, агенты
`CLAUDE.md`	Краткий справочник + команды сборки	Claude Code
`.github/copilot-instructions.md`	Инструкции для Copilot	GitHub Copilot

Godot MCP Bridge