MCP-сервер №1 для Godot Engine

Создавай игры на Godot
с суперсилой AI

Godot MCP Pro — это MCP-сервер со 163 инструментами, который соединяет AI-ассистентов вроде Claude и Cursor напрямую с редактором Godot 4 через WebSocket. AI может создавать сцены, писать GDScript, симулировать ввод игрока, инспектировать запущенную игру, строить 3D-окружения, настраивать физику, управлять частицами и аудио — всё из одного диалога. $5 единоразово, работает на Windows, macOS и Linux.

$5 единоразово · Пожизненные обновления

Смотри в действии

Один промпт → AI собирает полноценную игру «Реверси», запускает её и тестирует кликами мыши.

Смотреть полное демо на YouTube →
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor

Двусторонняя связь в реальном времени. Без опроса файлов. Без запуска CLI-процессов. Мгновенная обратная связь.

Руководства и туториалы

Практические руководства по Godot 4 с AI. Никакой устаревшей информации о Godot 3 — всё проверено на Godot 4.4+.

Подключи AI к Godot 4

Настрой MCP Pro за 5 минут и позволь Claude или Cursor напрямую управлять редактором Godot. Установи плагин, собери сервер, настрой AI-клиент — и ты готов.

"Получи информацию о проекте и покажи дерево сцены"
Начальный ~5 min
Использует: get_project_info get_scene_tree
🎮

Создай 2D-игру с нуля

Попроси AI создать полноценную 2D-игру — сцены, скрипты, сигналы, интерфейс. Это руководство описывает создание настольной игры «Реверси» в одном диалоге с AI, от пустого проекта до играбельной игры.

"Создай игру Реверси с полем 8x8, ходами по клику, AI-противником и отображением счёта"
Начальный ~15 min
Использует: create_scene add_node create_script connect_signal play_scene
🧑

3D-контроллер персонажа

Создай контроллер от третьего лица с анимациями Mixamo, стейт-машиной AnimationTree, камерой SpringArm3D и ландшафтом — всё создаётся AI. Охватывает CharacterBody3D, слои физики и смешивание анимаций в Godot 4.

"Создай 3D-сцену с ландшафтом, персонажем с x_bot.fbx с анимациями ходьбы/бега/прыжка и следящей камерой"
Средний ~20 min
Использует: add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3d
🔌

Паттерны сигналов в Godot 4

Godot 4 полностью переработал сигналы по сравнению с Godot 3. Больше никакого connect("signal", obj, "method") — используй signal.connect(callable). Позволь AI проанализировать архитектуру сигналов, найти неподключённые сигналы и визуализировать поток сигналов по проекту.

"Проанализируй поток сигналов в моём проекте и найди неподключённые сигналы"
Средний ~10 min
Использует: analyze_signal_flow find_signal_connections get_signals connect_signal
🤖

Автоматическое тестирование игры

Позволь AI протестировать твою игру. Запусти игру, симулируй ввод с клавиатуры/мыши, делай скриншоты, проверяй состояние игры и запускай стресс-тесты со случайным вводом. Не нужен фреймворк для тестов — MCP Pro всё делает на уровне редактора.

"Запусти игру, иди вправо 2 секунды, прыгни, затем проверь, что игрок добрался до платформы"
Средний ~10 min
Использует: play_scene simulate_key capture_frames assert_node_state run_stress_test
🎬

Стейт-машины AnimationTree

AnimationTree в Godot 4 — мощный, но сложный инструмент. Позволь AI создавать стейт-машины с переходами и условиями, настраивать деревья смешивания и параметры — самый частый камень преткновения для новичков в Godot, решённый за минуты.

"Создай AnimationTree с состояниями Idle, Walk, Run и Jump с правильными переходами"
Продвинутый ~15 min
Использует: create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameter
💥

Физика и столкновения

В Godot 4 PhysicsBody переименован в CharacterBody/RigidBody, а API слоёв столкновений изменился. Позволь AI настроить формы столкновений, правильно сконфигурировать слои физики, добавить рейкасты и провести аудит — избегая самых частых ошибок с физикой.

"Настрой столкновения для всех узлов CharacterBody2D и организуй слои физики по типам (player, enemy, environment)"
Средний ~10 min
Использует: setup_collision set_physics_layers setup_physics_body get_collision_info

Сборник эффектов частиц

В Godot 4 CPUParticles заменены на GPUParticles2D/3D по умолчанию. Создавай огонь, дым, дождь, снег и искры с помощью встроенных пресетов или тонко настраивай форму эмиссии, кривые скорости и градиенты цвета — всё через промпты на естественном языке.

"Добавь частицы огня к факелу с градиентом от оранжевого к красному и примени пресет огня"
Начальный ~5 min
Использует: create_particles apply_particle_preset set_particle_color_gradient set_particle_material

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

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

Установи плагин

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

Собери MCP-сервер

Выполни npm install && npm run build в директории server/. Это скомпилирует TypeScript MCP-сервер, который связывает твой AI-клиент с плагином Godot.

Начинай строить с AI

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

163
Инструментов
23
Категорий
16
Эксклюзивных категорий
(нет у конкурентов)
Отмена/Повтор
для всех изменений

163 инструмента, 23 категории

Всё, что нужно AI для создания, инспекции, тестирования и модификации твоего проекта Godot в 2D и 3D.

Project

7 tools
  • get_project_info metadata & autoloads
  • get_filesystem_tree recursive file tree
  • search_files fuzzy/glob search
  • get/set_project_settings read & write
  • uid_to_project_path UID conversion
  • project_path_to_uid path conversion

Scene

9 tools
  • get_scene_tree live hierarchy
  • get_scene_file_content raw .tscn
  • create_scene new scenes
  • open_scene delete_scene save_scene
  • add_scene_instance prefab-like instancing
  • play_scene stop_scene

Node

11 tools
  • add_node delete_node rename_node
  • duplicate_node deep copy
  • move_node reparent
  • update_property smart type parsing
  • get_node_properties inspect all props
  • add_resource shapes, materials
  • set_anchor_preset UI anchors
  • connect_signal disconnect_signal

Script

6 tools
  • list_scripts project-wide overview
  • read_script create_script
  • edit_script search/replace & insert
  • attach_script attach to nodes
  • get_open_scripts editor awareness

Editor

9 tools
  • get_editor_errors errors & stack traces
  • get_editor_screenshot editor viewport
  • get_game_screenshot running game
  • compare_screenshots visual diff NEW
  • execute_editor_script run GDScript
  • get_signals inspect signal connections
  • reload_plugin reload_project
  • clear_output

Input Simulation

5 tools
  • simulate_key keyboard with modifiers
  • simulate_mouse_click positioned clicks
  • simulate_mouse_move absolute/relative
  • simulate_action Godot InputActions
  • simulate_sequence multi-event combos

Runtime Analysis

15 tools
  • get_game_scene_tree live game hierarchy
  • get/set_game_node_properties runtime inspection & tweaking
  • execute_game_script run code in live game
  • capture_frames multi-frame screenshots
  • monitor_properties property timeline
  • start/stop/replay_recording input recording & replay NEW
  • find_nodes_by_script get_autoload
  • find_ui_elements click_button_by_text NEW
  • wait_for_node batch_get_properties NEW

Animation

6 tools
  • list_animations create_animation
  • add_animation_track value/position/bezier
  • set_animation_keyframe insert keys
  • get_animation_info tracks & keyframes
  • remove_animation

AnimationTree NEW

8 tools
  • create_animation_tree with state machine root
  • get_animation_tree_structure full tree inspection
  • add/remove_state_machine_state manage states
  • add/remove_state_machine_transition with conditions
  • set_blend_tree_node Add2, Blend2, TimeScale
  • set_tree_parameter conditions & blends

TileMap

6 tools
  • tilemap_set_cell place tiles
  • tilemap_fill_rect fill regions
  • tilemap_get_cell read tile data
  • tilemap_clear clear all
  • tilemap_get_info tile set sources
  • tilemap_get_used_cells query used cells

3D Scene NEW

6 tools
  • add_mesh_instance primitives & .glb/.gltf import
  • setup_lighting sun/indoor/dramatic presets
  • set_material_3d full PBR material setup
  • setup_environment sky, fog, glow, SSAO, SSR
  • setup_camera_3d projection, FOV, cull mask
  • add_gridmap GridMap with MeshLibrary

Physics NEW

6 tools
  • setup_collision auto-detect 2D/3D shapes
  • set/get_physics_layers layer & mask management
  • add_raycast RayCast2D/3D
  • setup_physics_body CharacterBody & RigidBody config
  • get_collision_info full collision audit

Particles NEW

5 tools
  • create_particles GPUParticles 2D/3D
  • set_particle_material direction, velocity, emission shape
  • set_particle_color_gradient color ramp stops
  • apply_particle_preset fire, smoke, rain, snow, sparks
  • get_particle_info full config inspection

Navigation NEW

5 tools
  • setup_navigation_region auto-detect 2D/3D
  • bake_navigation_mesh mesh baking & polygon gen
  • setup_navigation_agent pathfinding & avoidance
  • set_navigation_layers layer management
  • get_navigation_info full nav audit

Audio NEW

6 tools
  • get_audio_bus_layout full bus overview
  • add_audio_bus set_audio_bus create & configure
  • add_audio_bus_effect reverb, delay, compressor, EQ
  • add_audio_player 2D/3D audio players
  • get_audio_info subtree audio audit

Theme & UI

6 tools
  • create_theme new Theme resource
  • set_theme_color color overrides
  • set_theme_constant constant overrides
  • set_theme_font_size font sizes
  • set_theme_stylebox StyleBoxFlat
  • get_theme_info inspect overrides

Shader

6 tools
  • create_shader with templates
  • read_shader edit_shader
  • assign_shader_material to nodes
  • set_shader_param set uniforms
  • get_shader_params read all params

Resource NEW

3 tools
  • read_resource inspect .tres properties
  • edit_resource modify & save
  • create_resource new .tres of any type

Batch & Refactoring

6 tools
  • find_nodes_by_type search by class
  • find_signal_connections audit signals
  • batch_set_property bulk changes
  • find_node_references cross-file search
  • get_scene_dependencies dependency graph
  • cross_scene_set_property project-wide changes NEW

Testing & QA NEW

5 tools
  • run_test_scenario automated test sequences
  • assert_node_state property assertions
  • assert_screen_text UI text verification
  • run_stress_test random input fuzzing
  • get_test_report pass/fail summary

Code Analysis NEW

6 tools
  • find_unused_resources dead asset detection
  • analyze_signal_flow signal graph mapping
  • analyze_scene_complexity node count & depth
  • find_script_references cross-project search
  • detect_circular_dependencies cycle detection
  • get_project_statistics full project overview

Profiling

2 tools
  • get_performance_monitors FPS, memory, physics
  • get_editor_performance quick summary

Export

3 tools
  • list_export_presets configured presets
  • export_project build commands
  • get_export_info paths & templates

Почему Pro?

Функции, которых нет у бесплатных альтернатив.

Управление сигналами

Подключай, отключай и инспектируй сигналы между узлами. Ни один конкурент не поддерживает это. Необходимо для событийной архитектуры Godot.

Полная отмена/повтор

Каждое изменение проходит через систему UndoRedo Godot. Ctrl+Z для всего, что делает AI. Бесплатные альтернативы модифицируют сцены напрямую без отмены.

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

Vector2(100,200), #ff0000, Color(1,0,0) — AI отправляет строки, а мы автоматически парсим их в правильные типы Godot.

Надёжное соединение

WebSocket с heartbeat, автопереподключением (экспоненциальный откат) и автосканированием портов. Никаких обрывов соединения и ручных перезапусков.

Контекстные подсказки по ошибкам

Ошибки включают структурированные коды и рекомендации к действию. AI может исправлять ошибки самостоятельно, не застревая на непонятных сообщениях.

Полные операции с узлами

11 инструментов для узлов: добавление, удаление, переименование, дублирование, перемещение, обновление свойств, добавление ресурсов, настройка якорей. Ни один конкурент не покрывает всё это.

Симуляция ввода и запись

Позволь AI играть в твою игру. Симуляция клавиатуры, мыши и InputActions. Запись сессий ввода и воспроизведение для регрессионного тестирования с покадровой точностью.

Анализ в реальном времени

15 инструментов для инспекции запущенной игры. Чтение и изменение свойств во время выполнения, захват кадров, мониторинг изменений свойств, поиск UI-элементов, клики по кнопкам по тексту и ожидание появления узлов.

Анимация и AnimationTree

Создание анимаций, добавление дорожек, вставка ключевых кадров. Построение стейт-машин с переходами и условиями. Настройка деревьев смешивания с узлами Add2, Blend2 и TimeScale.

Построение 3D-сцен

Добавление мешей (примитивы или .glb/.gltf), настройка освещения с пресетами, конфигурация PBR-материалов, создание окружений с небом/туманом/SSAO/SSR, размещение камер и построение GridMap.

Физика и навигация

Настройка форм столкновений, конфигурация физических тел, управление слоями столкновений, добавление рейкастов. Создание навигационных регионов, запекание навмешей, настройка агентов навигации.

Частицы и аудио

Создание GPU-систем частиц с пресетами (огонь, дым, дождь, снег). Управление аудиошинами, добавление эффектов (реверберация, задержка, компрессор), размещение 2D/3D-аудиоплееров.

Работа с шейдерами

Создание шейдеров из шаблонов, редактирование GLSL-кода, назначение ShaderMaterial и настройка uniform-переменных в реальном времени. Полный цикл работы с шейдерами без выхода из AI-чата.

Тестирование и QA

Запуск автоматических тестовых сценариев с симуляцией ввода и проверками. Верификация текста UI на экране. Стресс-тесты со случайным вводом. Генерация отчётов о прохождении/провале тестов.

Анализ кода

Поиск неиспользуемых ресурсов, маппинг потоков сигналов, анализ сложности сцен, обнаружение циклических зависимостей, поиск ссылок на скрипты и полная статистика проекта.

Пакетные операции

Поиск узлов по типу, аудит подключений сигналов, массовая установка свойств по сценам, поиск по всем файлам проекта и анализ зависимостей. Рефакторинг в масштабе.

Что AI может делать в твоём проекте Godot?

Реальные примеры того, что можно попросить AI-ассистента сделать — и это просто работает.

Собрать полную игру с нуля

"Создай настольную игру Реверси с полем 8x8, ходами по клику, AI-противником и отображением счёта."

AI создаёт сцены, пишет скрипты, подключает сигналы, настраивает интерфейс и запускает игру — всё в одном диалоге. Смотри демо-видео.

Использует: create_scene add_node create_script connect_signal play_scene

Настроить 3D-окружение

"Добавь меш ландшафта, настрой драматичное освещение с тенями, сконфигурируй PBR-материалы с roughness 0.3 и добавь туман с volumetric density 0.02."

AI добавляет меши, настраивает пресеты освещения, конфигурирует PBR-материалы и подстраивает параметры окружения — всё через API редактора с полной отменой/повтором.

Использует: add_mesh_instance setup_lighting set_material_3d setup_environment

Автоматическое плейтестирование

"Запусти игру, проведи персонажа вправо 2 секунды, прыгни, затем проверь, добрался ли игрок до платформы."

AI запускает игру, симулирует ввод с клавиатуры, делает скриншоты, инспектирует свойства узлов в реальном времени и проверяет состояние игры — обеспечивая автоматизированный QA.

Использует: play_scene simulate_key get_game_screenshot get_game_node_properties assert_node_state

Отладка ошибок GDScript

"Проверь ошибки в редакторе и исправь их."

AI читает вывод ошибок редактора и ошибки компиляции скриптов, определяет проблему, редактирует скрипт для исправления и проверяет результат — замкнутый цикл обратной связи без копирования сообщений об ошибках.

Использует: get_editor_errors read_script edit_script get_editor_errors

Добавить эффекты частиц

"Добавь частицы огня к узлу факела с градиентом от оранжевого к красному и восходящей скоростью."

AI создаёт GPU-частицы, настраивает форму эмиссии и скорость, применяет градиенты цвета или использует встроенные пресеты (огонь, дым, дождь, снег, искры) для мгновенного результата.

Использует: create_particles set_particle_material set_particle_color_gradient

Рефакторинг по сценам

"Найди все узлы CharacterBody2D в проекте и установи их floor_snap_length в 8."

AI ищет по всем сценам, находит подходящие узлы и массово изменяет свойства — задачи, которые заняли бы минуты ручных кликов, решаются за секунды.

Использует: find_nodes_by_type batch_set_property cross_scene_set_property

Сравнение

Как Godot MCP Pro выглядит на фоне альтернатив.

Функция Godot MCP Pro GDAI MCP ($19) godot-mcp (free)
Всего инструментов163~3013
Категории23~84
СоединениеWebSocket + heartbeatWebSocketHeadless CLI
Undo/RedoYesYesNo
Управление сигналамиYesNoNo
Переименование/Дублирование/Перемещение узловYesNoNo
Умный парсинг типовYesLimitedNo
Симуляция вводаKey / Mouse / Action / SequenceNoNo
Анализ в реальном времени15 инструментов (дерево, свойства, кадры, UI, запись)NoNo
3D-инструментыMesh, Lighting, PBR, Environment, CameraNoNo
Настройка физикиCollision, Layers, Raycasts, BodiesNoNo
ЧастицыGPU 2D/3D with presetsNoNo
НавигацияRegion, Mesh baking, AgentNoNo
АудиоBuses, Effects, PlayersNoNo
AnimationTreeState machine, Blend treeNoNo
Автоматическое тестированиеСценарии, проверки, стресс-тестыNoNo
Анализ кодаНеиспользуемые ресурсы, поток сигналов, сложностьNoNo
СкриншотыРедактор + Игра + Визуальное сравнениеYesNo

Часто задаваемые вопросы

Ответы на частые вопросы о Godot MCP Pro.

Что такое Godot MCP Pro?

Godot MCP Pro — это премиальный MCP-сервер (Model Context Protocol), который соединяет AI-ассистентов вроде Claude, Cursor и Cline напрямую с редактором Godot 4 через WebSocket. Он предоставляет 163 инструмента в 23 категориях для управления сценами, анимации, 3D-моделирования, настройки физики, эффектов частиц, управления аудио, редактирования шейдеров, симуляции ввода, анализа в реальном времени и автоматического тестирования.

Как подключить Claude к Godot?

Установи плагин Godot MCP Pro в свой проект, включи его в Project Settings > Plugins, собери MCP-сервер командой npm install && npm run build и добавь его в файл .mcp.json. Claude (Code или Desktop) автоматически подключится к редактору Godot через WebSocket и получит доступ ко всем 163 инструментам.

Какие AI-ассистенты работают с Godot MCP Pro?

Любой MCP-совместимый AI-клиент, включая Claude Code, Claude Desktop, Cursor, VS Code с расширением Cline, Windsurf и другие инструменты, поддерживающие стандарт Model Context Protocol. Протокол MCP — открытый стандарт, и новые клиенты добавляются регулярно.

Может ли AI создавать 3D-игры в Godot?

Да. Godot MCP Pro включает специализированные 3D-инструменты для добавления примитивных мешей или импорта моделей .glb/.gltf, настройки освещения с пресетами, конфигурации PBR-материалов, создания окружений с небом/туманом/SSAO/SSR, размещения камер и построения GridMap. В сочетании с инструментами физики, навигации и частиц AI может создавать полноценные 3D-игровые сцены.

Может ли AI тестировать мою игру?

Да. Набор анализа в реальном времени включает 15 инструментов, которые позволяют AI запускать игру, симулировать ввод клавиатуры/мыши/действий, делать скриншоты, инспектировать дерево сцены в реальном времени, читать и изменять свойства при выполнении, записывать и воспроизводить сессии ввода, находить UI-элементы, нажимать кнопки по тексту и запускать автоматические тестовые сценарии с проверками.

Работает ли с Cursor?

Да. Godot MCP Pro работает с Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop и любым другим MCP-совместимым клиентом. Настрой MCP-сервер в параметрах редактора, и он подключится через WebSocket.

Какая версия Godot требуется?

Godot 4.4 или новее (протестировано на Godot 4.6) и Node.js 18+. Работает на Windows, macOS и Linux.

Чем это лучше бесплатных альтернатив?

Godot MCP Pro предлагает 163 инструмента по сравнению с 13–32 у бесплатных альтернатив. Эксклюзивные функции: полная отмена/повтор, управление сигналами, симуляция ввода с записью/воспроизведением, 15-инструментный набор анализа в реальном времени, построение 3D-сцен, настройка физики, системы частиц, управление аудиошинами, инструменты навигационных мешей, стейт-машины AnimationTree, автоматическое тестирование и анализ кода.

Исходный код плагина доступен?

Да. GDScript-плагин для редактора (addons/godot_mcp/) полностью с открытым исходным кодом и доступен на GitHub. Ты можешь изучить, как плагин взаимодействует с редактором, перед покупкой. MCP-сервер (TypeScript) входит в платную загрузку.

Нужна ли подписка?

Нет. Godot MCP Pro — это единоразовая покупка за $5 с пожизненными обновлениями для v1.x, неограниченным количеством проектов и машин, а также поддержкой в Discord. Никаких регулярных платежей и лимитов на места.

Быстрая настройка

Начни работу менее чем за 5 минут.

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

Скопируй папку addons/godot_mcp/ из загрузки в корневую директорию своего проекта Godot. Затем включи плагин:

Project > Project Settings > Plugins > Godot MCP Pro > Enable

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

Открой терминал в директории server/:

cd server
npm install
npm run build

3. Настрой AI-клиент

Добавь сервер в файл конфигурации MCP своего AI-клиента (например, .mcp.json для Claude Code):

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}

4. Начинай использовать

Открой проект Godot с включённым плагином. Панель статуса в доке редактора показывает состояние соединения. Запусти AI-ассистента и начинай строить — теперь у него есть прямой доступ к 163 инструментам в твоём редакторе Godot.

Простая, разовая цена

Заплати один раз — пользуйся всегда. Пожизненные обновления для v1.x включены.

$5
Разовый платёж
  • ✓ Все 163 инструмента в 23 категориях
  • ✓ Поддержка 2D и 3D
  • ✓ Пожизненные обновления (v1.x)
  • ✓ Неограниченное количество проектов
  • ✓ Неограниченное количество устройств
  • ✓ Канал поддержки в Discord
Купить на itch.io Buy Me a Coffee Вопросы? Присоединяйся к нашему Discord