Better Godot MCP
Better Godot MCP
mcp-name: io.github.n24q02m/better-godot-mcp
Servidor MCP compuesto para Godot Engine -- 17 mega-herramientas para el desarrollo de juegos asistido por IA
Características
17 mega-herramientas compuestas -- escena, nodo, script, shader, animación, tilemap, física, audio, navegación, interfaz de usuario y más
Control total de escenas -- crea, analiza y modifica archivos
.tscndirectamente sin tener Godot en ejecuciónCRUD de GDScript -- crea, lee, escribe y adjunta scripts en una sola llamada
Optimización de tokens por niveles -- descripciones comprimidas + herramienta
helpbajo demanda
Related MCP server: Godot MCP Unified
Configuración
Con un agente de IA -- copia y envía esto a tu agente de IA:
Por favor, configura @n24q02m/better-godot-mcp para mí. Sigue esta guía: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md
Configuración manual -- sigue docs/setup-manual.md
Herramientas
Herramienta | Acciones | Descripción |
|
| Metadatos del proyecto, ejecutar/detener y ajustes |
|
| Gestión de archivos de escena |
|
| Manipulación de nodos del árbol de escenas |
|
| CRUD de archivos GDScript |
|
| Iniciar el editor de Godot y comprobar el estado |
|
| Configuración del servidor y detección del entorno |
|
| Gestión de archivos de recursos |
|
| Mapeo de acciones y eventos de entrada |
|
| Conexiones de señales |
|
| Reproductores y pistas de animación |
|
| Gestión de TileMap y TileSet |
|
| CRUD de archivos de shader con sintaxis de Godot 4 |
|
| Capas de colisión y cuerpos físicos |
|
| Gestión de buses y efectos de audio |
|
| Regiones, agentes y obstáculos de navegación |
|
| Creación y temas de controles de interfaz de usuario |
| - | Obtener documentación completa para cualquier herramienta |
Configuración
El binario de Godot se detecta automáticamente desde las ubicaciones de instalación comunes y PATH. No se requieren variables de entorno para el uso básico. Opcionalmente, establece GODOT_PROJECT_PATH y GODOT_PATH para anular los valores predeterminados.
Variable | Requerido | Predeterminado | Descripción |
| No | - | Ruta del proyecto predeterminada (las herramientas también aceptan el parámetro |
| No | Detectado automáticamente | Ruta al binario de Godot |
Limitaciones
Requiere una estructura de proyecto de Godot 4.x
Los archivos de escena (
.tscn) se analizan/modifican mediante manipulación de texto, no a través de la API interna de GodotLas acciones
run/stop/exportrequieren que el binario de Godot esté instaladoEl modo Docker tiene acceso limitado al sistema de archivos (monta tu directorio de proyecto)
Seguridad
Detección de binarios -- Detección de Godot en múltiples rutas (entorno, PATH, ubicaciones comunes)
Validación de proyectos -- Verifica que
project.godotexista antes de realizar operacionesMultiplataforma -- Manejo de rutas en Windows, macOS y Linux
Construir desde el código fuente
git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run devLicencia
MIT -- Ver LICENSE.
Available Tools
17 toolsanimationC
Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.
Inputs: action (required), loop, name, parent, +7 more. Returns: object
audioC
Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.
Inputs: action (required), bus, name, parent, +6 more. Returns: object
configAIdempotent
Server configuration and environment.
Actions (required params -> optional):
status: current config
set (key, value): update setting
detect_godot: find Godot binary path
check: verify project and Godot availability
Inputs: action (required), key, value. Returns: object
editorAIdempotent
Godot editor control.
Actions (required params -> optional):
launch (-> project_path): open editor
status (-> project_path): check if editor is running
For running the game, use project(action="run") instead.
Inputs: action (required), project_path. Returns: object
helpARead-onlyIdempotent
Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.
Inputs: topic.
input_mapADestructive
Input action management.
Actions (required params -> optional):
list (-> project_path): all input actions
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: e.g., KEY_SPACE.
Inputs: action (required), deadzone, event_type, action_name, +2 more. Returns: object
nodesADestructive
Scene node operations.
Actions (required params -> optional):
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)
Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.
Inputs: action (required), name, type, value, +5 more. Returns: object
physicsC
Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.
Inputs: action (required), mass, name, dimension, +6 more. Returns: object
projectA
Godot project operations.
Actions (required params -> optional):
info (-> project_path): project metadata
version: Godot engine version
run (-> scene_path, project_path): launch game
logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started)
stop: stop running game
settings_get (key -> project_path): read project setting
settings_set (key, value -> project_path): write project setting
export (preset, output_path -> project_path): export game build
Inputs: action (required), key, pid, value, +4 more. Returns: object
resourcesBDestructive
Resource file management.
Actions (required params -> optional):
list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource)
info (resource_path -> project_path): resource metadata
delete (resource_path -> project_path)
import_config (resource_path -> project_path): view import settings
Inputs: action (required), type, project_path, resource_path. Returns: object
scenesADestructive
Scene file (.tscn) CRUD.
Actions (required params -> optional):
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: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.
Inputs: action (required), new_path, root_name, root_type, +2 more. Returns: object
scriptsADestructive
GDScript file CRUD.
Actions (required params -> optional):
create (script_path -> extends="Node", content, project_path): generate template
read (script_path -> project_path)
write (script_path, content -> project_path): replace entire file
attach (script_path, scene_path, node_name -> project_path): link to scene node
list (-> project_path)
delete (script_path -> project_path)
script_path: relative to project root (e.g., "scripts/player.gd").
Inputs: action (required), content, extends, node_name, +3 more. Returns: object
shaderC
Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.
Inputs: action (required), content, shader_path, shader_type, +1 more. Returns: object
signalsADestructive
Signal connection management.
Actions (required params -> optional):
list (scene_path -> project_path): all signal connections
connect (scene_path, signal, from, to, method -> flags, project_path)
disconnect (scene_path, signal, from, to, method -> project_path)
Inputs: action (required), to, from, flags, +4 more. Returns: object
tilemapC
TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.
Inputs: action (required), tile_size, scene_path, project_path, +2 more. Returns: object
uiC
UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.
Inputs: action (required), name, type, parent, +5 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct Godot subsystem, and explicit notes (e.g., editor launch vs project run) reduce confusion. Some overlap remains between project settings and config, and between scenes and generic resource management.
Tool names follow a consistent single-noun domain pattern with verb-style actions underneath. Minor inconsistencies like plural scenes/nodes/scripts vs singular animation/shader and the underscore in input_map prevent a perfect score.
At roughly 16-17 tools, the server sits at the upper edge of the ideal range, but each tool covers a separate Godot domain and earns its place. It is slightly heavy but not bloated.
The surface covers the core Godot development lifecycle: project, editor, scenes, scripts, resources, input, signals, rendering, physics, audio, navigation, and UI. Minor gaps exist, such as no generic resource creation and abbreviated documentation for several advanced domains.
Maintenance
Related MCP Connectors
Generate, search and export game-ready sprite sheets for Godot, Unity and other game engines.
Search, generate, refine, and export pixel art VFX for games, including sprite sheets and Godot 4.
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
Related MCP Servers
- AlicenseAqualityAmaintenanceMarkdown-first MCP server for Notion that provides 7 composite action-based tools consolidating 28+ REST API endpoints, enabling AI agents to efficiently manage pages, databases, blocks, and content with automatic pagination and bulk operations.101,730 npm36Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables complete natural language control of Godot Engine 4.5+ with 76 tools for managing scripts, scenes, nodes, animations, physics, tilemaps, audio, shaders, navigation, particles, UI, lighting, assets, and exports. Integrates with Claude Desktop, VS Code, and Ollama for AI-assisted game development.2MIT
- AlicenseAqualityAmaintenanceWeb search (embedded SearXNG), content extraction, and library docs indexing with hybrid search. No API keys required.6733 PyPI24Apache 2.0
- AlicenseAqualityAmaintenancePersistent AI memory with SQLite hybrid search (FTS5 + semantic), built-in Qwen3 embedding, and rclone sync across machines.15585 PyPI13Apache 2.0