godot-mcp — MCP-сервер для Claude Code: что делает и как установить
Связывает ИИ-ассистента с запущенным редактором Godot 4.4+. Позволяет менять сцены, узлы и скрипты проекта напрямую без ручного копирования кода.
claude mcp add godot-mcp -- npx -y godot-mcp-serverЧто делает godot-mcp
Сервер соединяет ассистента в Claude Code или Cursor с движком Godot через локальный WebSocket на порту 6505. Для работы нужен Node.js и включённый плагин godot_mcp внутри каталога addons/. После перезапуска проекта редактор отображает статус подключения агента в правом верхнем углу.
Набор включает 32 инструмента по шести направлениям. Ассистент умеет добавлять сцены, настраивать ноды, проверять синтаксис GDScript и считывать карту ввода. Команда map_project запускает интерактивный граф зависимостей проекта в браузере на localhost:6510.
Стандартная комбинация Ctrl+Z в Godot не откатывает правки агента, потому что плагин сразу сохраняет изменения на диск. Для возврата к прошлому состоянию используйте отдельный инструмент mcp_undo. Сервер работает строго локально и управляет только одним окном редактора.
Какие задачи решает
- создавать сцены и менять свойства узлов прямо из чата с ассистентом
- редактировать скрипты GDScript с автоматической проверкой синтаксиса
- исследовать вызовы функций и сигналы через граф на localhost:6510
- считывать дерево сцен и ошибки консоли Godot без переключения окон
Примеры запросов агенту
- Добавь в текущую сцену ноду CharacterBody2D с коллизией и создай базовый скрипт движения.
- Вызови команду map_project и открой граф зависимостей проекта.
- Откати последнее изменение в сцене с помощью инструмента mcp_undo.
Как установить godot-mcp
Командой платформы
claude mcp add godot-mcp -- npx -y godot-mcp-serverКомандой платформы
codex mcp add mcp-server -- npx -y godot-mcp-serverФайл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"godot-mcp-server"
]
}
}
}Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-mcp-server"
]
}
}
}Командой платформы
gemini mcp add mcp-server npx -y godot-mcp-serverПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о godot-mcp
Как установить godot-mcp в Claude Code?
Установите Node.js и выполните команду claude mcp add godot-mcp -- npx -y godot-mcp-server. Затем скопируйте папку плагина в каталог addons/ вашего проекта Godot и включите его в настройках проекта.
Что делает godot-mcp?
Сервер транслирует команды ассистента в запущенный редактор Godot 4.4+ через WebSocket. Он позволяет читать состояние проекта, редактировать код скриптов и собирать сцены на лету.
Почему в редакторе Godot не работает Ctrl+Z для правок ассистента?
Плагин сразу сохраняет файлы на диск, минуя встроенную историю действий Godot. Чтобы отменить операцию, попросите агента запустить инструмент mcp_undo.
