Godot MCP Runtime — MCP-сервер для Godot 4: что делает
Даёт ИИ-агенту управление проектом Godot 4 без открытого редактора и снимает скриншоты, шлёт ввод и запускает GDScript в идущей игре. Пригодится, когда агент должен сам проверить правку, а не отдавать её вам.
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env DEBUG=<DEBUG> --env GODOT_MCP_DISABLE_ELICITATION=<GODOT_MCP_DISABLE_ELICITATION> --env GODOT_MCP_STRICT=<GODOT_MCP_STRICT> --env GODOT_MCP_DISABLE_SECURITY=<GODOT_MCP_DISABLE_SECURITY> --transport stdio godot-mcp-runtime -- npx -y godot-mcp-runtimeЧто делает Godot MCP Runtime
Сервер работает поверх npx и не требует аддона в проекте. При запуске run_project он подкладывает автозагрузку McpBridge, та слушает localhost по TCP и отдаёт инструменты: снимок вьюпорта (по умолчанию превью 960x540 и полный PNG на диск), имитацию нажатий и кликов, обход живого дерева сцены с поиском видимых Control, выполнение произвольного GDScript с доступом к SceneTree. С флагом profiling: true снимаются данные профайлера Godot и ранжируются самые дорогие функции GDScript.
Редактирование идёт без окна редактора: сцены, узлы, свойства, привязка скриптов, сигналы, проверка GDScript. Для тихих прогонов есть background: true, тогда окно уезжает за экран и не принимает физический ввод. Если игру запускает не MCP, а CI или ваш шелл, сначала вызовите attach_project – мост встанет в проект, и рантайм-инструменты заработают на внешней сессии.
Ограничение про одно: в присоединённом режиме get_debug_output не работает, потому что stdout и stderr сервер видит только у процессов, которые запустил сам. Нужен поток логов – запускайте через run_project. Мост снимается при stop_project, detach_project, выходе из игры или падении клиента; артефакты лежат в .mcp/godot-runtime/, путь сервер дописывает в .gitignore. Это не замена плейтесту: агент подтвердит, что сцена грузится и кнопка реагирует, а ощущение игры он не оценит.
Какие задачи решает
- проверить, что сцена грузится без ошибок
- снять скриншот вьюпорта из запущенной игры
- прогнать нажатия и клики по UI и увидеть, что изменилось
- выполнить GDScript в живом дереве сцены
- найти самые дорогие функции GDScript по профайлеру
Примеры запросов агенту
- Запусти проект Godot в фоне и сними скриншот главного меню
- Симулируй клик по кнопке Start и покажи, что поменялось на экране
- Присоединись к уже запущенной игре через
attach_projectи прогони скрипт по дереву сцены
Как установить Godot MCP Runtime
Командой платформы
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env DEBUG=<DEBUG> --env GODOT_MCP_DISABLE_ELICITATION=<GODOT_MCP_DISABLE_ELICITATION> --env GODOT_MCP_STRICT=<GODOT_MCP_STRICT> --env GODOT_MCP_DISABLE_SECURITY=<GODOT_MCP_DISABLE_SECURITY> --transport stdio godot-mcp-runtime -- npx -y godot-mcp-runtimeВместо <…> подставьте свои значения
Командой платформы
codex mcp add godot-mcp-runtime --env GODOT_PATH=<GODOT_PATH> --env DEBUG=<DEBUG> --env GODOT_MCP_DISABLE_ELICITATION=<GODOT_MCP_DISABLE_ELICITATION> --env GODOT_MCP_STRICT=<GODOT_MCP_STRICT> --env GODOT_MCP_DISABLE_SECURITY=<GODOT_MCP_DISABLE_SECURITY> -- npx -y godot-mcp-runtimeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"godot-mcp-runtime": {
"command": "npx",
"args": [
"-y",
"godot-mcp-runtime"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"DEBUG": "<DEBUG>",
"GODOT_MCP_DISABLE_ELICITATION": "<GODOT_MCP_DISABLE_ELICITATION>",
"GODOT_MCP_STRICT": "<GODOT_MCP_STRICT>",
"GODOT_MCP_DISABLE_SECURITY": "<GODOT_MCP_DISABLE_SECURITY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"godot-mcp-runtime": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-mcp-runtime"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"DEBUG": "<DEBUG>",
"GODOT_MCP_DISABLE_ELICITATION": "<GODOT_MCP_DISABLE_ELICITATION>",
"GODOT_MCP_STRICT": "<GODOT_MCP_STRICT>",
"GODOT_MCP_DISABLE_SECURITY": "<GODOT_MCP_DISABLE_SECURITY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GODOT_PATH=<GODOT_PATH> -e DEBUG=<DEBUG> -e GODOT_MCP_DISABLE_ELICITATION=<GODOT_MCP_DISABLE_ELICITATION> -e GODOT_MCP_STRICT=<GODOT_MCP_STRICT> -e GODOT_MCP_DISABLE_SECURITY=<GODOT_MCP_DISABLE_SECURITY> godot-mcp-runtime npx -y godot-mcp-runtimeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Godot MCP Runtime
Как установить Godot MCP Runtime в Claude Code?
Выполните claude mcp add godot-mcp-runtime -- npx -y godot-mcp-runtime. Если нужны переменные окружения, есть второй вариант с --env для GODOT_PATH, DEBUG, GODOT_MCP_DISABLE_ELICITATION, GODOT_MCP_STRICT, GODOT_MCP_DISABLE_SECURITY и --transport stdio.
Что делает Godot MCP Runtime?
Позволяет агенту править проект Godot 4 без редактора и управлять запущенной игрой: скриншоты, имитация ввода, поиск UI-элементов, живой GDScript, профайлинг функций.
Останутся ли следы в проекте после работы?
Нет. Автозагрузка вставляется на время сессии и снимается при остановке, выходе из игры или отключении. Артефакты копятся в .mcp/godot-runtime/, и сервер сам добавляет эту папку в .gitignore.
