godot-mcp-enhanced — MCP-сервер для Claude Code: Godot
Даёт агенту 46 MCP-инструментов, чтобы читать, писать, запускать и проверять проекты Godot 4.5–4.7 без открытия редактора.
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhancedЧто делает godot-mcp-enhanced
Сервер соединяет ИИ-клиент с движком через три слоя: headless, editor и game bridge. Агент создаёт проект, пишет сцены и скрипты, запускает игру и снимает скриншот, а после правок прогоняет компиляцию каждого скрипта. Всего заявлено 46 инструментов с 272 действиями — сцены, UI, анимация, физика, частицы, навигация, аудио, экспорт.
Отдельная часть — проверка. qa запускает настоящую игру со структурными тестами и утверждениями, playtest.seed фиксирует генератор случайных чисел, поэтому один и тот же ввод даёт один и тот же результат между запусками. verify_delivery проверяет целостность дерева сцены, здоровье скриптов и производительность. Game bridge держит TCP-соединение с работающей игрой: читает дерево узлов и свойства, слушает сигналы, подделывает ввод, записывает и воспроизводит прохождение.
Есть и защита: белый список путей ALLOWED_PROJECT_PATHS работает по принципу deny-by-default, а параметр godot_path и проектные override отклоняются, пока не настроен GODOT_MCP_ALLOWED_GODOT_PATHS. Без этого списка агент не сможет указать на произвольный бинарник — это стоит настроить сразу, если работаете в недоверенном окружении. Установка Godot не обязательна заранее: npx godot-mcp-enhanced install скачает сборку и зарегистрирует её в поисковой цепочке.
Какие задачи решает
- собрать сцену и скрипты Godot по текстовому описанию
- запустить проект и получить структурированный разбор ошибок
- зафиксировать seed и воспроизвести баг между запусками
- снять скриншот или GIF из работающей игры
- проверить готовность сборки перед экспортом
Примеры запросов агенту
- Создай проект Godot и сделай сцену с персонажем, который прыгает по нажатию пробела
- Запусти игру и покажи, какие ошибки вылезли в консоли
- Прогони qa-набор и скажи, прошли ли все утверждения
Как установить godot-mcp-enhanced
Командой платформы
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhancedВместо <…> подставьте свои значения
Командой платформы
codex mcp add godot-mcp-enhanced --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> -- npx -y godot-mcp-enhancedВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"godot-mcp-enhanced": {
"command": "npx",
"args": [
"-y",
"godot-mcp-enhanced"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
"ALLOWED_PROJECT_PATHS": "<ALLOWED_PROJECT_PATHS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"godot-mcp-enhanced": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-mcp-enhanced"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
"ALLOWED_PROJECT_PATHS": "<ALLOWED_PROJECT_PATHS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GODOT_PATH=<GODOT_PATH> -e GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> -e ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> godot-mcp-enhanced npx -y godot-mcp-enhancedВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Геймдев и 3D: Unity, Unreal, Godot, Blender»
Всё по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →Вопросы о godot-mcp-enhanced
Как установить godot-mcp-enhanced в Claude Code?
Базовый вариант: claude mcp add godot-mcp-enhanced -- npx -y godot-mcp-enhanced. Если нужны пути к движку и проекту, добавьте переменные: `claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhanced`.
Что делает godot-mcp-enhanced?
Открывает агенту доступ к проекту Godot: чтение и запись сцен и скриптов, запуск игры, скриншоты, детерминированные тесты и проверка перед экспортом. Работает через три слоя — headless, editor и game bridge.
Нужен ли установленный Godot?
Нет. Команда npx godot-mcp-enhanced install скачивает сборку с официальных релизов и регистрирует её в поисковой цепочке и белом списке путей.
