Better Godot MCP

Name: Better Godot MCP
Author: n24q02m

mcp-name: io.github.n24q02m/better-godot-mcp

Составной MCP-сервер для Godot Engine -- 17 мега-инструментов для разработки игр с помощью ИИ

codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

Возможности

17 составных мега-инструментов -- сцена, узел, скрипт, шейдер, анимация, тайлмап, физика, аудио, навигация, UI и многое другое
Полный контроль над сценами -- создание, парсинг и изменение файлов .tscn напрямую без запуска Godot
CRUD для GDScript -- создание, чтение, запись и прикрепление скриптов одним вызовом
Многоуровневая оптимизация токенов -- сжатые описания + инструмент help по запросу

Related MCP server: WET - Web Extended Toolkit

Настройка

С помощью ИИ-агента -- скопируйте и отправьте это своему ИИ-агенту:

Пожалуйста, настрой для меня @n24q02m/better-godot-mcp. Следуй этому руководству: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md

Ручная настройка -- следуйте docs/setup-manual.md

Инструменты

Инструмент	Действия	Описание
`project`	`info`, `version`, `run`, `stop`, `settings_get`, `settings_set`, `export`	Метаданные проекта, запуск/остановка и настройки
`scenes`	`create`, `list`, `info`, `delete`, `duplicate`, `set_main`	Управление файлами сцен
`nodes`	`add`, `remove`, `rename`, `list`, `set_property`, `get_property`	Манипуляция узлами дерева сцены
`scripts`	`create`, `read`, `write`, `attach`, `list`, `delete`	CRUD для файлов GDScript
`editor`	`launch`, `status`	Запуск редактора Godot и проверка статуса
`config`	`status`, `set`, `detect_godot`, `check`	Конфигурация сервера и обнаружение окружения
`resources`	`list`, `info`, `delete`, `import_config`	Управление файлами ресурсов
`input_map`	`list`, `add_action`, `remove_action`, `add_event`	Отображение действий ввода и событий
`signals`	`list`, `connect`, `disconnect`	Соединения сигналов
`animation`	`create_player`, `add_animation`, `add_track`, `add_keyframe`, `list`	Плееры анимации и треки
`tilemap`	`create_tileset`, `add_source`, `set_tile`, `paint`, `list`	Управление TileMap и TileSet
`shader`	`create`, `read`, `write`, `get_params`, `list`	CRUD для шейдеров с синтаксисом Godot 4
`physics`	`layers`, `collision_setup`, `body_config`, `set_layer_name`	Слои коллизий и физические тела
`audio`	`list_buses`, `add_bus`, `add_effect`, `create_stream`	Управление аудиошинами и эффектами
`navigation`	`create_region`, `add_agent`, `add_obstacle`	Навигационные регионы, агенты и препятствия
`ui`	`create_control`, `set_theme`, `layout`, `list_controls`	Создание элементов управления UI и тем
`help`	-	Получить полную документацию для любого инструмента

Конфигурация

Бинарный файл Godot автоматически обнаруживается в стандартных местах установки и в PATH. Для базового использования переменные окружения не требуются. При необходимости установите GODOT_PROJECT_PATH и GODOT_PATH для переопределения значений по умолчанию.

Переменная	Обязательно	По умолчанию	Описание
`GODOT_PROJECT_PATH`	Нет	-	Путь к проекту по умолчанию (инструменты также принимают параметр `project_path`)
`GODOT_PATH`	Нет	Автоопределение	Путь к бинарному файлу Godot

Ограничения

Требуется структура проекта Godot 4.x
Файлы сцен (.tscn) парсятся/изменяются через текстовую манипуляцию, а не через внутренний API Godot
Действия run/stop/export требуют установленного бинарного файла Godot
В режиме Docker ограничен доступ к файловой системе (монтируйте директорию вашего проекта)

Безопасность

Обнаружение бинарных файлов -- Обнаружение Godot по нескольким путям (env, PATH, стандартные расположения)
Проверка проекта -- Проверяет наличие project.godot перед выполнением операций
Кроссплатформенность -- Обработка путей для Windows, macOS, Linux

Сборка из исходного кода

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev

Лицензия

MIT -- См. LICENSE.

Better Godot MCP

Better Godot MCP

Возможности

Настройка

Инструменты

Конфигурация

Ограничения

Безопасность

Сборка из исходного кода

Лицензия

Resources

Tools

Latest Blog Posts

MCP directory API