Godot MCP — Instalar & Demo en vivo

Name: Godot MCP MCP Server
Author: Coding-Solo

Por qué usarlo

Características clave

Ejecuta proyectos Godot 4 en modo headless con captura estructurada de stdout
Lanza el editor en un proyecto específico
Ejecuta una escena individual (--scene path.tscn) para iteración rápida
Obtiene información del proyecto — escena principal, versión, autoloads
Detiene procesos en ejecución
Multiplataforma — funciona donde corra el binario de Godot

Demo en vivo

Cómo se ve en la práctica

godot-mcp-coding-solo.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godot-mcp-coding-solo": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "godot-mcp-coding-solo",
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "godot-mcp-coding-solo": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "godot-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add godot-mcp-coding-solo -- npx -y godot-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Godot MCP

Bucle de iteración ajustado sobre un bug de GDScript

👤 Devs en solitario / indie devs ⏱ ~20 min intermediate

Cuándo usarlo: El movimiento del jugador se rompió después de un refactor; quieres que Claude lo arregle sin volver a Godot cada minuto.

Requisitos previos

Godot 4 instalado — Descarga de godotengine.org
Variable de entorno GODOT_PATH — Apunta al binario de Godot (no al .app en macOS)

Flujo

Contexto del proyecto

Godot: obtén información del proyecto en /Users/me/games/Platformer. Lista los autoloads + escena principal.✓ Copiado

→ Nombre del proyecto, versión, lista de autoloads devueltos
Ejecutar la escena que falla

Ejecuta la escena scenes/Level1.tscn en modo headless con timeout de 10 segundos. Muestra stderr.✓ Copiado

→ stderr capturado; línea de error + traceback visible
Corregir y volver a ejecutar

El error es 'Invalid call to method move_and_slide on null'. Lee scripts/Player.gd, encuentra la causa, corrígela, luego vuelve a ejecutar la escena.✓ Copiado

→ Archivo editado, la escena vuelve a ejecutarse, sin más error null

Resultado: Bug encontrado y corregido en 5 minutos sin salir del chat.

Errores comunes

La ejecución headless se cuelga en un diálogo modal — Usa timeout; comprueba stderr para ver el título del diálogo
GODOT_PATH apunta a la arquitectura incorrecta (Intel vs ARM en Mac) — Verifica con file $GODOT_PATH

Combinar con: filesystem · github

Montar una máquina de estados del jugador desde cero

👤 Devs que empiezan un nuevo proyecto ⏱ ~25 min intermediate

Cuándo usarlo: Quieres un boilerplate de máquina de estados (Idle/Run/Jump/Attack) sin copiar y pegar.

Requisitos previos

Proyecto Godot vacío — Crea desde el Project Manager

Flujo

Generar archivos

Crea scripts/State.gd (clase base) más IdleState/RunState/JumpState/AttackState que la extienden. Usa señales para las transiciones. Guarda bajo res://scripts/states/.✓ Copiado

→ 5 nuevos archivos .gd en el lugar correcto
Conectar Player.gd

Actualiza scripts/Player.gd para instanciar la máquina de estados y delegar _physics_process al estado actual. Mantén el manejo de entrada mínimo.✓ Copiado

→ Player.gd tiene state_machine, current_state, transiciones
Prueba de humo

Ejecuta scenes/Player.tscn durante 3 segundos. Busca errores en tiempo de ejecución.✓ Copiado

→ Ejecución limpia; lista para añadir gameplay

Resultado: Boilerplate de máquina de estados funcionando — listo para añadir estados reales.

Errores comunes

Olvidar la declaración class_name en State.gd — Añádela para que las clases hijas puedan usar el tipo

Combinar con: filesystem

Ejecutar tests de gut en modo headless desde CI

👤 Devs configurando CI ⏱ ~30 min advanced

Cuándo usarlo: Quieres tests unitarios que corran en GitHub Actions en cada push.

Requisitos previos

Addon de testing Gut — Instala via Asset Library o submódulo git

Flujo

Ejecutar localmente primero

Godot: ejecuta la escena addons/gut/gui/GutRunner.tscn en modo headless. Captura el código de salida.✓ Copiado

→ Tests ejecutados; código de salida 0 en verde
Generar workflow

Ahora escribe un .github/workflows/test.yml que haga lo mismo en Ubuntu usando godot-headless 4.x.✓ Copiado

→ Archivo de workflow con la acción de configuración de Godot correcta

Resultado: CI reproducible para tests de Godot.

Errores comunes

El modo headless falla en llamadas de display — Usa --headless y evita OS.window_* en los tests

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

godot-mcp-coding-solo + filesystem

Editar GDScript y volver a ejecutar la escena en bucle ajustado

Filesystem: edita scripts/Player.gd para añadir cooldown de salto. Godot: ejecuta scenes/Player.tscn durante 3 segundos. Muestra stderr.✓ Copiado

godot-mcp-coding-solo + github

Abrir un PR después de que Claude corrija un bug de gameplay

Godot: confirma que el bug está corregido volviendo a ejecutar la escena. GitHub: abre un PR con el fix y el fragmento de log relevante.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
get_project_info	project_path: str	Primera llamada, verificación de sanidad	gratis
launch_editor	project_path: str	Abrir la UI de Godot	gratis
run_project	project_path, headless?: bool, timeout?: int	Prueba de humo del proyecto completo	gratis
run_scene	project_path, scene_path, headless?, timeout?	Iterar en una escena individual	gratis
stop_process	pid: int	Matar una ejecución colgada	gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — local
Tokens por llamada: 200–8000 (stdout/stderr puede ser grande)
Monetario: OSS gratuito; Godot es gratuito
Consejo: Usa timeout agresivamente en run_scene; no dejes que los bucles infinitos consuman tokens

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: ejecutar el binario de Godot

Almacenamiento de credenciales: Ninguno

Salida de datos: Solo local

No conceder nunca: shell arbitraria

run_project ejecutará cualquier GDScript del proyecto — apunta solo a proyectos de confianza

Resolución de problemas

Errores comunes y soluciones

GODOT_PATH no encontrado

Configura la ruta absoluta al binario de Godot; en Mac usa el binario dentro del .app

Verificar: $GODOT_PATH --version

La ejecución headless se cuelga

Siempre pasa timeout; comprueba stderr para diálogo modal o compilación de shaders

Versión incorrecta de Godot

MCP es solo para Godot 4.x; las escenas 3.x no cargarán

Verificar: godot --version

Alternativas

Godot MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
godot.unitynoid (mcp-godot)	Quieres un fork diferente	Menos probado en batalla
Bevy / Rapier MCPs	Usas Rust/Bevy	Motor completamente diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills