Godot MCP

¿Qué es Godot MCP?

Godot MCP es un complemento para el motor Godot que actúa como un puente entre tus proyectos de Godot y los asistentes de IA utilizando el Protocolo de Contexto del Modelo estandarizado. Permite que las herramientas de IA accedan, analicen y modifiquen scripts, escenas, nodos y configuraciones de proyectos directamente, habilitando nuevos flujos de trabajo impulsados por IA para el desarrollo, la depuración y la colaboración creativa.

Cómo Configurar Godot MCP

• Clona el repositorio godot-mcp y navega a su directorio.
• Construye y configura el servidor MCP ejecutando npm install y npm run build en el directorio /server.
• Edita tu archivo de configuración de Claude Desktop (por ejemplo, claude_desktop_config.json) para agregar una entrada del servidor MCP que apunte al archivo de entrada de tu servidor construido.
• Asegúrate de reemplazar RUTA_A_TU_PROYECTO con la ruta absoluta de tu repositorio clonado.
• Reinicia Claude Desktop para aplicar los cambios.
• En Godot, abre el proyecto de ejemplo proporcionado o agrega la carpeta addons/godot_mcp al directorio de complementos de tu propio proyecto.
• Habilita el complemento desde Proyecto > Configuración del Proyecto > Complementos en el Editor de Godot.

Cómo Usar Godot MCP

Con el servidor MCP en funcionamiento y el complemento habilitado, interactúa con tu proyecto de Godot desde la interfaz del asistente de IA (por ejemplo, Claude Desktop) utilizando indicaciones estructuradas o en lenguaje natural. Prefija los comandos con @mcp godot-mcp para enviar solicitudes a través del servidor MCP. Puedes solicitar sugerencias de código, cambios en escenas, contenido generado por IA y ejecutar comandos de proyecto o recursos directamente.

Ejemplos de Indicaciones

• @mcp godot-mcp read godot://script/current
  "Necesito ayuda para optimizar mi código de movimiento del jugador. ¿Puedes sugerir mejoras?"
• @mcp godot-mcp run get-scene-tree
  "Agrega un cubo en el medio de la escena y luego crea una cámara que mire el cubo."
• @mcp godot-mcp read godot://scene/current
  "Crea una IA enemiga que patrulle entre puntos de referencia y ataque al jugador cuando esté en rango."

Características Principales

• Comunicación bidireccional fluida entre Godot y asistentes de IA
• Acceso y modificación de recursos del proyecto, scripts, escenas y nodos mediante programación
• Amplio conjunto de comandos para gestión de nodos, edición de scripts, control de escenas y proyectos
• Fácilmente extensible con puntos finales de herramientas MCP adicionales
• Configuración segura, local o remota con soporte para integración a través de Claude Desktop
• Asistencia impulsada por IA en lenguaje natural para codificación, depuración y creación de escenas

Casos de Uso

• Revisión, generación y refactorización de código impulsada por IA para archivos GDScript
• Creación automática de escenas, gestión de nodos y generación procedural de entornos
• Análisis a nivel de proyecto para optimización de rendimiento o detección de errores
• Implementación de lógica de juego, comportamientos de IA y elementos de interfaz de usuario a través de sugerencias de IA
• Edición o creación por lotes de recursos y configuraciones con la orientación de IA
• Aceleración de la creación de prototipos, aprendizaje o desarrollo colaborativo en proyectos de Godot

Preguntas Frecuentes

P: El complemento no funciona o no aparece en Godot. ¿Qué debo hacer?
R: Asegúrate de haber habilitado el complemento "Godot MCP" en Proyecto > Configuración del Proyecto > Complementos. Si recientemente copiaste el complemento o realizaste cambios en la configuración, intenta recargar el proyecto y verifica si hay mensajes de error en la consola de Godot.

P: Claude Desktop no puede conectarse al servidor MCP. ¿Qué está mal?
R: Verifica que el servidor se esté ejecutando correctamente (sin errores al iniciar) y que tu configuración de Claude Desktop tenga la ruta absoluta correcta. Asegúrate de que MCP_TRANSPORT esté configurado en stdio. Reinicia Claude Desktop después de actualizar la configuración.

P: ¿Puedo usar Godot MCP con mis proyectos existentes o solo con el ejemplo incluido?
R: Sí, puedes usarlo con cualquier proyecto de Godot. Simplemente copia la carpeta addons/godot_mcp en el directorio de complementos de tu proyecto y habilita el complemento desde la configuración.

P: ¿Qué pasa si quiero extender Godot MCP o agregar comandos personalizados?
R: El complemento y el servidor son de código abierto y están diseñados para ser extensibles. Puedes implementar nuevos puntos finales en el servidor MCP o extender el complemento de Godot para exponer funcionalidad adicional.

P: ¿Es segura la información de mi proyecto al usar Godot MCP?
R: Sí, por defecto el servidor MCP se ejecuta en tu máquina local y solo accede a archivos y datos que permites. Revisa las configuraciones del servidor y siempre mantén en mente las mejores prácticas para la seguridad de los datos.