Godot MCP

Dale a tu asistente de IA acceso completo al editor de Godot.

Crea juegos más rápido con Claude, Cursor o cualquier IA compatible con MCP — sin copiar y pegar, sin cambiar de contexto. La IA lee, escribe y manipula directamente tus escenas, scripts, nodos y configuración del proyecto.

Godot 4.x · 42 herramientas · Visualizador interactivo de proyectos · Licencia MIT

Inicio rápido

0. Instalar Node.js (configuración única)

Descarga y ejecuta el instalador desde nodejs.org (versión LTS). Es un instalador estándar — no hace falta terminal.

1. Instalar el plugin de Godot

Dentro del editor de Godot, haz clic en la pestaña AssetLib en la parte superior → busca "mcp" → encuentra "Godot AI Assistant tools MCP" → Instalar.

Luego ve a Proyecto → Configuración del proyecto → Plugins y habilita el plugin Godot MCP.

2. Añadir la configuración del servidor a tu cliente de IA

Claude Desktop — Configuración → Desarrollador → Editar configuración → abre el archivo de configuración y pega:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Configuración → MCP → Añadir servidor:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — ejecuta en la terminal:

claude mcp add godot -- npx -y godot-mcp-server

Funciona con cualquier cliente compatible con MCP (Cline, Windsurf, etc.)

3. Reinicia tu cliente de IA

Cierra y vuelve a abrir Claude Desktop / Cursor / tu cliente para que cargue la nueva configuración.

4. Reinicia tu proyecto de Godot

Pulsa Reiniciar Proyecto en el editor de Godot. Comprueba la esquina superior derecha — deberías ver MCP Conectado en verde. Ya estás listo.

Related MCP server: Godot MCP

¿Qué puede hacer?

42 herramientas en 6 categorías

Visualizador interactivo

Ejecuta map_project y obtén un explorador basado en navegador en localhost:6510:

• Grafo de fuerza dirigida de todos los scripts y sus relaciones

• Haz clic en cualquier script para ver variables, funciones, señales y conexiones

• Edita código directamente en el visualizador — los cambios se sincronizan con Godot en tiempo real

• Vista de escena con edición de propiedades de nodo

• Busca usos antes de refactorizar

Limitaciones

La IA no puede crear el 100% de un juego por sí sola — le cuestan los diseños de interfaz complejos, la composición de escenas y algunas manipulaciones de propiedades de nodos. Sigue en desarrollo activo, ¡así que los comentarios son muy bienvenidos!

Arquitectura

┌─────────────┐    MCP (stdio)   ┌──────────────┐   WebSocket   ┌──────────────┐
│  AI Client  │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,   │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)   │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  42 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser    │
                                 │  Visualizer  │
                                 └──────────────┘

Limitaciones actuales

• Solo local — se ejecuta en localhost, sin conexiones remotas

• Conexión única — una instancia de Godot a la vez

• Sin deshacer — los cambios se guardan directamente (usa control de versiones)

• La IA todavía tiene un conocimiento limitado de Godot — no puede crear el 100% del juego por sí sola, pero puede ayudar a depurar, escribir scripts y acompañarte en el camino

Desarrollo

Para compilar desde el código fuente en lugar de usar npm:

cd mcp-server
npm install
npm run build

Luego dirige tu cliente de IA a mcp-server/dist/index.js en lugar de usar npx.

Notas de la versión

Los resúmenes narrativos de cada versión se encuentran en release-notes/ (empezando por v0.5.0). Para ver el historial completo de cambios, consulta CHANGELOG.md.

Licencia

MIT

paquete npm · Reportar problemas