Better Godot MCP

Name: Better Godot MCP
Author: n24q02m

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

codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

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 .tscn directamente sin tener Godot en ejecución
CRUD de GDScript -- crea, lee, escribe y adjunta scripts en una sola llamada
Optimización de tokens por niveles -- descripciones comprimidas + herramienta help bajo demanda

Related MCP server: WET - Web Extended Toolkit

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
`project`	`info`, `version`, `run`, `stop`, `settings_get`, `settings_set`, `export`	Metadatos del proyecto, ejecutar/detener y ajustes
`scenes`	`create`, `list`, `info`, `delete`, `duplicate`, `set_main`	Gestión de archivos de escena
`nodes`	`add`, `remove`, `rename`, `list`, `set_property`, `get_property`	Manipulación de nodos del árbol de escenas
`scripts`	`create`, `read`, `write`, `attach`, `list`, `delete`	CRUD de archivos GDScript
`editor`	`launch`, `status`	Iniciar el editor de Godot y comprobar el estado
`config`	`status`, `set`, `detect_godot`, `check`	Configuración del servidor y detección del entorno
`resources`	`list`, `info`, `delete`, `import_config`	Gestión de archivos de recursos
`input_map`	`list`, `add_action`, `remove_action`, `add_event`	Mapeo de acciones y eventos de entrada
`signals`	`list`, `connect`, `disconnect`	Conexiones de señales
`animation`	`create_player`, `add_animation`, `add_track`, `add_keyframe`, `list`	Reproductores y pistas de animación
`tilemap`	`create_tileset`, `add_source`, `set_tile`, `paint`, `list`	Gestión de TileMap y TileSet
`shader`	`create`, `read`, `write`, `get_params`, `list`	CRUD de archivos de shader con sintaxis de Godot 4
`physics`	`layers`, `collision_setup`, `body_config`, `set_layer_name`	Capas de colisión y cuerpos físicos
`audio`	`list_buses`, `add_bus`, `add_effect`, `create_stream`	Gestión de buses y efectos de audio
`navigation`	`create_region`, `add_agent`, `add_obstacle`	Regiones, agentes y obstáculos de navegación
`ui`	`create_control`, `set_theme`, `layout`, `list_controls`	Creación y temas de controles de interfaz de usuario
`help`	-	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
`GODOT_PROJECT_PATH`	No	-	Ruta del proyecto predeterminada (las herramientas también aceptan el parámetro `project_path`)
`GODOT_PATH`	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 Godot
Las acciones run/stop/export requieren que el binario de Godot esté instalado
El 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.godot exista antes de realizar operaciones
Multiplataforma -- 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 dev

Licencia

MIT -- Ver LICENSE.

Install Server

A

security – no known vulnerabilities

A

license - permissive license

B

quality - B tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Tools

View all tools

Better Godot MCP

Better Godot MCP

Características

Configuración

Herramientas

Configuración

Limitaciones

Seguridad

Construir desde el código fuente

Licencia

Resources

Tools

Latest Blog Posts

MCP directory API