better-godot-mcp

Integración de Godot Engine: 17 herramientas para desarrollo de juegos

Documentación

Better Godot MCP

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

Servidor MCP compuesto para Godot Engine -- 17 herramientas compuestas para desarrollo de juegos asistido por IA.

Proyectos hermanos de n24q02m (haz clic para expandir)

Proyecto	Lema	Etiqueta
agent-chat-plugin	Agentes de IA pares conversan en una carpeta compartida — sin intermediario humano, sin orquestador, fun...	Tooling
better-code-review-graph	Grafo de conocimiento para revisiones de código eficientes en tokens -- búsqueda semántica y lla...	MCP
better-drive	Sincronización bidireccional de Google Drive con filtro .driveignore — motor rclone, bandeja de Windows	Tooling
better-email-mcp	Correo IMAP/SMTP para agentes de IA -- leer, enviar, organizar carpetas y gestionar adj...	MCP
better-godot-mcp	Servidor MCP compuesto para Godot Engine -- 17 herramientas compuestas para desarrollo de juegos asistido por IA...	MCP
better-notion-mcp	Notion centrado en Markdown para agentes de IA -- páginas, bases de datos, bloques y comentarios...	MCP
better-semantic-release	Fork de python-semantic-release como reemplazo directo con protecciones de seguridad de lanzamiento integradas (or...	Tooling
better-telegram-mcp	Telegram para agentes de IA -- mensajes, chats, medios y contactos en ambos l...	MCP
better-workspace-mcp	Servidor MCP de Google Workspace (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch...	MCP
claude-plugins	Mercado de plugins de Claude Code para los servidores MCP de n24q02m -- instalar búsqueda web...	Marketplace
imagine-mcp	Comprensión y generación de imágenes y vídeos para agentes de IA -- en Gemini, Op...	MCP
jules-task-archiver	Extensión de Chrome para operaciones masivas en tareas de Jules mediante la API batchexecute -- a...	Tooling
mcp-core	Base compartida para construir servidores MCP -- transporte HTTP Streamable, OAut...	MCP
mnemo-mcp	Memoria persistente de IA con búsqueda híbrida y sincronización integrada. Abierta, gratuita, ilimi...	MCP
qwen3-embed	Embedding de texto Qwen3 ligero y reordenamiento mediante ONNX Runtime y GGUF	Library
skret	Secretos sin servidor.	CLI
tacet	Una cascada neuro-simbólica de autodestilación que amortiza el coste de LLM en el conoci...	Tooling
web-core	Paquete de infraestructura web compartida para búsqueda, scraping, seguridad HTTP y al...	Library
wet-mcp	Servidor MCP de código abierto para agentes de IA: búsqueda web, extracción de contenido y bib...	MCP

Características

17 mega-herramientas compuestas -- escena, nodo, script, shader, animación, tilemap, física, audio, navegación, UI y más
Control total de escenas -- crear, analizar y modificar archivos .tscn directamente sin que Godot esté en ejecución
CRUD de GDScript -- crear, leer, escribir y adjuntar scripts en una sola llamada
Optimización de tokens por niveles -- descripciones comprimidas + herramienta help bajo demanda

Instalación

Se ejecuta sobre stdio por defecto. Sin credenciales, sin cuenta, sin intermediario -- el servidor lee y escribe directamente los archivos de tu proyecto local de Godot. Godot 4.x es opcional para operaciones de archivos; solo las acciones run/stop/export y editor necesitan un binario de Godot. El detector acepta Godot >=4.1. La compatibilidad con el motor en vivo está verificada actualmente con Godot 4.7.1 estable; esto no afirma que se haya verificado cada futura versión menor.

Mediante npx (recomendado)

npx -y @n24q02m/better-godot-mcp@latest

Configuración del cliente MCP

Añade a la configuración MCP de tu cliente (Claude Code, Cursor, Windsurf, Codex, mcp.json):

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

GODOT_PROJECT_PATH es opcional -- cada herramienta también acepta un argumento project_path por llamada.

Mediante Docker

docker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp

La imagen se publica para amd64 y arm64. Monta tu directorio de proyecto para que el servidor pueda leer y escribir archivos de escena, script y recursos.

Smithery

better-godot-mcp incluye un smithery.yaml para que pueda descubrirse e implementarse a través de Smithery. Smithery lanza el servidor sobre stdio mediante npx -y @n24q02m/better-godot-mcp, y no se requiere configuración para iniciarlo -- el servidor no tiene credenciales y lee directamente los archivos de tu proyecto local de Godot.

Documentación

Guía de configuración completa en mcp.n24q02m.com/servers/better-godot-mcp/setup/ -- pasos de instalación para Claude Code, Codex, Gemini CLI, Cursor, Windsurf y mcp.json.

Instalar con agente de IA -- pega esto en tu agente de codificación de IA:

Instala el servidor MCP better-godot-mcp siguiendo los pasos en https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.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 escena
`scripts`	`create`, `read`, `write`, `attach`, `list`, `delete`	CRUD de archivos GDScript
`editor`	`launch`, `status`	Lanzar 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 de entrada y eventos
`signals`	`list`, `connect`, `disconnect`	Conexiones de señales
`animation`	`create_player`, `add_animation`, `add_track`, `add_keyframe`, `list`	Reproductores de animación y pistas
`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 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 de audio y efectos
`navigation`	`create_region`, `add_agent`, `add_obstacle`	Regiones de navegación, agentes y obstáculos
`ui`	`create_control`, `set_theme`, `layout`, `list_controls`	Creación de controles de UI y tematización
`help`	-	Obtén documentación completa de cualquier herramienta

Comparación

Cómo se compara better-godot-mcp con sus competidores directos en cada pilar:

Capacidad	better-godot-mcp	Coding-Solo/godot-mcp	bradypp/godot-mcp	tugcantopaloglu/godot-mcp
Gestión de archivos de escena	Sí (`scenes`: create/list/info/delete/duplicate/set_main)	Sí (create/save)	Sí (create/save)	Sí (create/read/modify)
Manipulación del árbol de nodos	Sí (`nodes`: add/remove/rename/list/get+set_property)	Parcial (solo añadir)	Sí (add/edit/remove)	Sí (add/remove/reparent)
CRUD de archivos GDScript	Sí (`scripts`: create/read/write/attach/list/delete)	No	No	Parcial (crear desde plantilla + evaluación en tiempo de ejecución)
CRUD de archivos shader	Sí (`shader`: create/read/write/get_params/list)	No	No	Parcial (crear/leer .gdshader)
Creación de animaciones	Sí (`animation`: player/track/keyframe)	No	No	Sí (player/tween/máquina de estados)
TileMap / TileSet	Sí (`tilemap`: tileset/source/set_tile/paint)	No	No	Sí (celdas TileMapLayer)
Capas de física / cuerpos	Sí (`physics`: layers/collision/body_config)	No	No	Sí (collision/joints/raycast)
Gestión de buses de audio	Sí (`audio`: buses/effects/streams)	No	No	Sí (buses/routing/effects)
Configuración de navegación	Sí (`navigation`: region/agent/obstacle)	No	No	Sí (navigation)
Creación de controles de UI	Sí (`ui`: control/theme/layout)	No	Parcial (mediante add node)	Sí (controls/themes/menus)
Edición del mapa de entrada	Sí (`input_map`: action/event)	No	No	Sí (actions/key bindings)
Conexiones de señales	Sí (`signals`: connect/disconnect/list)	No	No	Sí (connect/emit/await)
Lanzar editor / ejecutar proyecto	Sí (`editor`, `project` run/stop)	Sí	Sí	Sí
Funciona sin editor en ejecución	Sí (análisis de `.tscn` basado en texto)	Sí (puente GDScript sin interfaz)	Sí (puente GDScript sin interfaz)	Parcial (CLI sin interfaz o socket TCP en vivo)
Sin credenciales almacenadas (TC-Local)	Sí	Sí	Sí	Sí
Transportes stdio + HTTP	Sí (stdio por defecto + `--http`)	No (solo stdio)	No (solo stdio)	No (solo stdio)
Imagen Docker (amd64 + arm64)	Sí	No	No	No
Descripciones de herramientas por niveles de tokens	Sí (compacto + `help` bajo demanda)	No	No	No

Configuración

El binario de Godot se detecta automáticamente desde 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 sobrescribir los valores predeterminados.

Variable	Requerida	Predeterminado	Descripción
`GODOT_PROJECT_PATH`	No	-	Ruta de proyecto predeterminada (las herramientas también aceptan un parámetro `project_path`)
`GODOT_PATH`	No	Detección automática	Ruta al binario de Godot

Transporte HTTP

El servidor se ejecuta sobre stdio por defecto. Para servir sobre HTTP Streamable en su lugar, pasa --http o establece MCP_TRANSPORT=http (TRANSPORT_MODE=http también se acepta). El modo HTTP expone un endpoint /mcp sin autenticación -- no hay credenciales que proteger, por lo que está pensado para uso local de confianza o autoalojado.

Variable	Requerida	Predeterminado	Descripción
`MCP_TRANSPORT`	No	`stdio`	Establece en `http` para transporte HTTP Streamable
`PORT`	No	`0` (asignación automática)	Puerto HTTP (solo modo HTTP)
`HOST`	No	Predeterminado del servidor	Host HTTP (solo modo HTTP)

Limitaciones

Requiere una estructura de proyecto de Godot 4.x; un binario de Godot es opcional para operaciones de archivos
Los archivos de escena (.tscn) se analizan/modifican mediante manipulación de texto, no mediante 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)

CLI

El binario better-godot-mcp ejecuta el servidor MCP por defecto (stdio; agrega --http para Streamable HTTP). También expone dos subcomandos de diagnóstico para verificar tu entorno de Godot antes de conectar un cliente MCP.

Comando	Descripción
`better-godot-mcp`	Inicia el servidor MCP (stdio por defecto; `--http` para Streamable HTTP)
`better-godot-mcp detect`	Imprime el binario de Godot detectado como JSON (ruta, versión, fuente); sale con código no cero cuando no se encuentra ninguno
`better-godot-mcp doctor`	Verifica el estado del binario de Godot y del proyecto actual (`GODOT_PROJECT_PATH`, de lo contrario el directorio de trabajo)

# Detect the Godot binary (JSON output)
npx -y @n24q02m/better-godot-mcp detect

{
  "found": true,
  "path": "/path/to/godot",
  "version": {
    "major": 4,
    "minor": 7,
    "patch": 1,
    "label": "stable.official",
    "raw": "4.7.1.stable.official"
  },
  "source": "system"
}

# Health-check the Godot binary and project
npx -y @n24q02m/better-godot-mcp doctor

[ok] godot binary: /path/to/godot (source: system)
[ok] godot version: 4.7.1.stable.official
[warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)

detect sale con 1 cuando no se encuentra ningún binario de Godot; doctor sale con 1 cuando falta el binario (una project.godot faltante es solo una advertencia).

Seguridad

Detección de binario -- Detección de Godot en múltiples rutas (env, PATH, ubicaciones comunes)
Validación de proyecto -- Verifica que project.godot exista antes de las operaciones
Multiplataforma -- Manejo de rutas en Windows, macOS, Linux

Compilar desde el código fuente

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev          # stdio mode (default)
bun run dev:http     # Streamable HTTP mode

Modelo de confianza

Este plugin implementa TC-Local (sin autenticación requerida -- no se almacenan credenciales). Consulta la referencia del modelo de confianza para la clasificación completa.

Modo	Almacenamiento	Cifrado	¿Quién puede leer tus datos?
stdio (por defecto)	N/A (sin credenciales)	N/A	N/A
HTTP autoalojado	N/A (sin credenciales)	N/A	N/A

Licencia

Apache-2.0 -- Consulta LICENSE.