Каталог MCP
n24q02m
n24q02m/better-godot-mcp

n24q02m/better-godot-mcp

Сервер для разработки игр на Godot Engine с AI-агентами: 17 инструментов для управления сценами, скриптами и ресурсами напрямую, без запуска редактора. Ускоряет создание прототипов.

README

17 инструментов

Установить сервер

Better Godot MCP

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

Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.

License: MIT

Sister projects from n24q02m (click to expand)

Project	Tagline	Tag
better-code-review-graph	Knowledge graph for token-efficient code reviews -- semantic search and call-...	MCP
better-email-mcp	IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att...	MCP
better-godot-mcp	Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g...	MCP
better-notion-mcp	Markdown-first Notion for AI agents -- pages, databases, blocks, and comments...	MCP
better-telegram-mcp	Telegram for AI agents -- messages, chats, media, and contacts across both bo...	MCP
claude-plugins	Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea...	Marketplace
imagine-mcp	Image and video understanding + generation for AI agents -- across Gemini, Op...	MCP
jules-task-archiver	Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a...	Tooling
mcp-core	Shared foundation for building MCP servers -- Streamable HTTP transport, OAut...	MCP
mnemo-mcp	Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi...	MCP
qwen3-embed	Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF	Library
skret	Secrets without the server.	CLI
tacet	TACET: a self-distilling neuro-symbolic cascade that amortises LLM cost in kn...	Tooling
web-core	Shared web infrastructure package for search, scraping, HTTP security, and st...	Library
wet-mcp	Open-source MCP server for AI agents: web search, content extraction, and lib...	MCP

animation

Управление анимацией. Действия: create_player|add_animation|add_track|add_keyframe|list. Используйте инструмент help для полной документации.

Параметры

actionenumобязательный
Action to perform
create_playeradd_animationadd_trackadd_keyframelist
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
namestring
AnimationPlayer node name
parentstring
Parent node path
anim_namestring
Animation name
durationnumber
Animation duration in seconds
loopboolean
Whether animation loops
track_typestring
Track type: value, method, bezier
node_pathstring
Target node path for track
propertystring
Target property for track

audio

Управление аудиошинами и потоками. Действия: list_buses|add_bus|add_effect|create_stream. Используйте help tool для полной документации.

Параметры

actionenumобязательный
Action to perform
list_busesadd_busadd_effectcreate_stream
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file (for create_stream)
bus_namestring
Audio bus name
send_tostring
Send bus target (default: Master)
effect_typestring
Effect type (for add_effect)
namestring
Stream player node name
stream_typestring
Stream type: 2D, 3D, or global
parentstring
Parent node path
busstring
Audio bus (default: Master)

configидемпотентный

Конфигурация сервера и окружение. Действия (обязательные параметры -> необязательные): - status: текущая конфигурация - set (key, value): обновляет настройку - detect_godot: находит путь к бинарному файлу Godot - check: проверяет проект и доступность Godot

Параметры

actionenumобязательный
Action to perform
statussetdetect_godotcheck
keystring
Config key (for set)
valuestring
Config value (for set)

editorидемпотентный

Контрол редактора Godot. Действия (обязательные параметры -> необязательные): - launch (-> project_path): открывает редактор - status (-> project_path): проверяет, запущен ли редактор Для запуска игры используйте project(action="run").

Параметры

actionenumобязательный
Action to perform
launchstatus
project_pathstring
Path to Godot project directory

helpтолько чтениеидемпотентный

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

Параметры

tool_nameenumобязательный
Tool to get documentation for
projectscenesnodesscriptseditorconfighelpresourcesinput_mapsignalsanimationtilemapshaderphysicsaudionavigationui

input_map

Управление входными действиями. Действия (обязательные параметры -> необязательные): - list (-> project_path): все входные действия - add_action (action_name -> deadzone=0.5, project_path) - remove_action (action_name -> project_path) - add_event (action_name, event_type, event_value -> project_path) event_type: key | mouse | joypad. event_value: например, KEY_SPACE.

Параметры

actionenumобязательный
Action to perform
listadd_actionremove_actionadd_event
project_pathstring
Path to Godot project directory
action_namestring
Input action name
deadzonenumber
Deadzone value (for add_action, default: 0.5)
event_typestring
Event type: key, mouse, joypad (for add_event)
event_valuestring
Event value, e.g., KEY_SPACE (for add_event)

navigation

Навигационные области, агенты, препятствия. Действия: create_region|add_agent|add_obstacle. Используйте help tool для полной документации.

Параметры

actionenumобязательный
Action to perform
create_regionadd_agentadd_obstacle
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
namestring
Node name
parentstring
Parent node path (default: .)
dimensionstring
2D or 3D (default: 3D)
radiusnumber
Agent/obstacle radius
max_speednumber
Agent max speed

nodes

Операции с узлами сцены. Действия (обязательные параметры -> необязательные): - add (scene_path, name -> type="Node", parent=".", project_path) - remove (scene_path, name -> project_path) - rename (scene_path, name, new_name -> project_path) - list (scene_path -> project_path) - set_property (scene_path, name, property, value -> project_path) - get_property (scene_path, name, property -> project_path) Пути узлов: относительно корня сцены с использованием "/" (например, "Player/Sprite2D"). Используйте "." для корня.

Параметры

actionenumобязательный
Action to perform
addremoverenamelistset_propertyget_property
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
namestring
Node name
typestring
Node type (for add, default: Node)
parentstring
Parent node path relative to scene root (for add, default: "." = root). Use "/" separator, e.g., "Player/Sprite2D"
new_namestring
New name (for rename)
propertystring
Property name (for get/set_property)
valuestring
Property value (for set_property)

physics

Physics config. Действия: layers|collision_setup|body_config|set_layer_name. Используйте help tool для полной документации.

Параметры

actionenumобязательный
Action to perform
layerscollision_setupbody_configset_layer_name
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
namestring
Node name
collision_layernumber
Collision layer bitmask
collision_masknumber
Collision mask bitmask
dimensionstring
2d or 3d (for set_layer_name)
layer_numbernumber
Layer number (for set_layer_name)
gravity_scalenumber
Gravity scale (for body_config)
massnumber
Mass (for body_config)

project

Операции с проектами Godot. Действия (обязательные параметры -> необязательные): - info (-> project_path): возвращает метаданные проекта - version: версия движка Godot - run (-> scene_path, project_path): запускает игру - logs (-> pid): последние захваченные строки stdout/stderr из запуска (по умолчанию: последний запущенный) - stop: останавливает запущенную игру - settings_get (key -> project_path): читает настройку проекта - settings_set (key, value -> project_path): записывает настройку проекта - export (preset, output_path -> project_path): экспортирует сборку игры

Параметры

actionenumобязательный
Action to perform
infoversionrunlogsstopsettings_getsettings_setexport
project_pathstring
Path to Godot project directory
scene_pathstring
Path to a specific scene to run (optional)
pidnumber
PID to read logs for (for logs; default: most recently started)
keystring
Settings key (for settings_get/set)
valuestring
Settings value (for settings_set)
presetstring
Export preset name (for export)
output_pathstring
Export output path (for export)

resources

Управление файлами ресурсов. Действия (обязательные параметры -> опциональные): - list (-> type, project_path): просматривает ресурсы (type: image|audio|font|shader|scene|resource) - info (resource_path -> project_path): получает метаданные ресурса - delete (resource_path -> project_path): удаляет - import_config (resource_path -> project_path): показывает настройки импорта

Параметры

actionenumобязательный
Action to perform
listinfodeleteimport_config
project_pathstring
Path to Godot project directory
resource_pathstring
Path to resource file
typestring
Filter by type: image, audio, font, shader, scene, resource (for list)

scenes

CRUD для файлов сцен (.tscn). Действия (обязательные параметры -> необязательные): - create (scene_path -> root_type="Node2D", root_name, project_path) - list (-> project_path) - info (scene_path -> project_path) - delete (scene_path -> project_path) - duplicate (scene_path, new_path -> project_path) - set_main (scene_path -> project_path) scene_path: относительно корня проекта (например, "scenes/main.tscn"), НЕ с префиксом res://. Используйте инструмент nodes для редактирования узлов в сцене.

Параметры

actionenumобязательный
Action to perform
createlistinfodeleteduplicateset_main
project_pathstring
Path to Godot project directory
scene_pathstring
Relative scene file path from project root (e.g., "scenes/main.tscn"), not res:// prefix
root_typestring
Root node type for create (default: Node2D)
root_namestring
Root node name for create
new_pathstring
Destination path (for duplicate)

scripts

GDScript file CRUD. Действия (обязательные параметры -> опциональные): - create (script_path -> extends="Node", content, project_path): генерирует шаблон - read (script_path -> project_path) - write (script_path, content -> project_path): заменяет весь файл - attach (script_path, scene_path, node_name -> project_path): привязывает к узлу сцены - list (-> project_path) - delete (script_path -> project_path) script_path: относительно корня проекта (например, "scripts/player.gd").

Параметры

actionenumобязательный
Action to perform
createreadwriteattachlistdelete
project_pathstring
Path to Godot project directory
script_pathstring
Path to GDScript file
extendsstring
Base class for create (default: Node)
contentstring
Script content (for create/write)
scene_pathstring
Scene file path (for attach)
node_namestring
Target node name (for attach)

shader

Управление шейдерами Godot. Действия: create|read|write|get_params|list. Для полной документации используйте help tool.

Параметры

actionenumобязательный
Action to perform
createreadwriteget_paramslist
project_pathstring
Path to Godot project directory
shader_pathstring
Path to .gdshader file
shader_typestring
Shader type: canvas_item, spatial, particles, sky, fog (for create)
contentstring
Shader content (for create/write)

signals

Управление подключениями сигналов. Действия (обязательные параметры -> необязательные): - list (scene_path -> project_path): все подключения сигналов - connect (scene_path, signal, from, to, method -> flags, project_path) - disconnect (scene_path, signal, from, to, method -> project_path)

Параметры

actionenumобязательный
Action to perform
listconnectdisconnect
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
signalstring
Signal name
fromstring
Source node path
tostring
Target node path
methodstring
Target method name
flagsnumber
Connection flags

tilemap

Управление TileSet и TileMap. Действия: create_tileset|add_source|set_tile|paint|list. Используйте help tool для полной документации.

Параметры

actionenumобязательный
Action to perform
create_tilesetadd_sourceset_tilepaintlist
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file (for list, paint)
tileset_pathstring
Path to TileSet .tres file (for create_tileset, add_source)
texture_pathstring
Texture source path (for add_source)
tile_sizenumber
Tile size in pixels (default: 16, for create_tileset)

ui

Узлы управления UI и темы. Действия: create_control|set_theme|layout|list_controls. Используйте инструмент help для полной документации.

Параметры

actionenumобязательный
Action to perform
create_controlset_themelayoutlist_controls
project_pathstring
Path to Godot project directory
scene_pathstring
Path to scene file
namestring
Control node name
typestring
Control type (e.g., Button, Label, HBoxContainer)
parentstring
Parent node path (default: .)
theme_pathstring
Path to theme .tres file (for set_theme)
presetstring
Layout preset: full_rect, center, top_wide, bottom_wide, left_wide, right_wide
font_sizenumber
Default font size (for set_theme)

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@n24q02m/better-godot-mcp"
  ],
  "env": {
    "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
  }
}

Также n24q02m/better-godot-mcp можно установить в Cursor по ссылке автоматически.

FAQ

Для чего этот сервер?

Better Godot MCP помогает AI-ассистентам напрямую работать с проектами Godot — создавать сцены, править скрипты, анимации и шейдеры, не запуская движок. Вместо того чтобы просто предлагать код, ассистент сам изменяет файлы проекта. Это ускоряет разработку игр: AI берёт на себя рутину, а разработчик сосредотачивается на механике и геймдизайне.

Что он умеет?

Сервер управляет Godot-проектами — читает метаданные, определяет версию движка, запускает редактор. Создаёт, изменяет и парсит .tscn-файлы, добавляет и удаляет узлы в сцене. Работает с GDScript — создаёт, читает, обновляет скрипты. Управляет ресурсами, вводом, сигналами, анимациями, тайловыми картами, шейдерами, физикой, аудио, навигацией и UI-контролами. Настраивает слои физики, эффекты аудиошины, регионы навигации и темы.

Информация о сервере

Номер в рейтинге: #183
Звезд на Github: 30
Форков на Github: 7
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.07 в 10:08
Идентификатор: IsvW6OiemZuOL8XI
Категории: Игры и геймификация, Инструменты для разработчиков

Другие проверенные MCP-сервера

tavily-ai/tavily-mcp

MCP сервер Tavily предоставляет инструменты для веб-поиска, извлечения данных и построения карты сайта в реальном времени. Помогает разработчикам AI-ассистентов получать актуальную информацию из интернета.

pydantic/logfire-mcp

официальный

MCP-сервер для интеграции с Logfire от Pydantic. Текущая версия архивирована — используйте новый удаленный сервер для быстрой итерации инструментов и лучшего опыта. Полезен разработчикам, работающим с логированием и мониторингом Pydantic Logfire.

awslabs/mcp

официальный

Набор open source MCP-серверов от AWS Labs для интеграции AI-ассистентов с AWS-сервисами. Упрощает облачную разработку, управление инфраструктурой, работу с базами данных и документацией прямо из I...

public-ui/kolibri

официальный

KoliBri - библиотека атомарных веб-компонентов для доступного HTML. Расширяет стандарт, не привязана к дизайну, подходит для любых проектов. Упрощает создание семантичных, валидных и доступных инте...

taylorwilsdon/google_workspace_mcp

Google Workspace MCP сервер для полного управления сервисами через естественный язык - Gmail, Drive, Calendar, Docs, Sheets и другие. Поддерживает OAuth 2.1 и многопользовательский режим. Идеален д...

runapi-ai/mcp

официальный

RunAPI MCP Server открывает 130+ моделей генерации медиа, музыки, речи и поиска промптов прямо из MCP-хостов — Claude Code, Cursor, VS Code. Идеально для быстрых экспериментов с генерацией без пере...