Godot MCP Pro es un servidor MCP con 163 herramientas que conecta asistentes de IA como Claude y Cursor directamente al editor Godot 4 vía WebSocket. Permite que la IA cree escenas, escriba GDScript, simule input del jugador, inspeccione juegos en ejecución, construya entornos 3D, configure física, administre partículas y audio — todo desde una sola conversación. $5 pago único, funciona en Windows, macOS y Linux.
$5 pago único · Actualizaciones de por vidaUn prompt → la IA construye un juego completo de Reversi, lo ejecuta y lo prueba con clics del mouse.
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
Comunicación bidireccional en tiempo real. Sin polling de archivos. Sin subprocesos CLI. Solo retroalimentación instantánea.
Guías prácticas para Godot 4 con IA. Sin información obsoleta de Godot 3 — todo aquí está probado en Godot 4.4+.
Configura MCP Pro en 5 minutos y deja que Claude o Cursor controlen directamente tu editor Godot. Instala el plugin, compila el servidor, configura tu cliente de IA — y listo.
get_project_info get_scene_treePide a la IA crear un juego 2D completo — escenas, scripts, señales, UI. Esta guía muestra cómo construir un juego de Reversi en una sola conversación con IA, desde proyecto vacío hasta juego jugable.
create_scene add_node create_script connect_signal play_sceneConstruye un controlador de personaje en tercera persona con animaciones Mixamo, máquina de estados AnimationTree, cámara SpringArm3D y terreno — todo creado por la IA. Cubre CharacterBody3D, capas de física y mezcla de animaciones en Godot 4.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dGodot 4 renovó las señales de Godot 3. Ya no se usa connect("signal", obj, "method") — usa signal.connect(callable). Deja que la IA audite tu arquitectura de señales, encuentre señales desconectadas y visualice el flujo de señales en tu proyecto.
analyze_signal_flow find_signal_connections get_signals connect_signalDeja que la IA pruebe tu juego. Ejecuta el juego, simula input de teclado/mouse, captura screenshots, verifica el estado del juego y ejecuta pruebas de estrés con input aleatorio. Sin necesidad de framework de pruebas — MCP Pro lo resuelve todo a nivel del editor.
play_scene simulate_key capture_frames assert_node_state run_stress_testEl AnimationTree de Godot 4 es poderoso pero complejo. Deja que la IA cree máquinas de estado con transiciones, configure blend trees, defina condiciones y conecte parámetros — el obstáculo más común para principiantes en Godot, resuelto en minutos.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterGodot 4 renombró PhysicsBody a CharacterBody/RigidBody y cambió las APIs de capas de colisión. Deja que la IA configure formas de colisión, defina capas de física correctamente, agregue raycasts y audite tu configuración de colisión — evitando los bugs de física más comunes.
setup_collision set_physics_layers setup_physics_body get_collision_infoGodot 4 reemplazó el CPUParticles predeterminado con GPUParticles2D/3D. Crea fuego, humo, lluvia, nieve y chispas con presets integrados, o ajusta la forma de emisión, curvas de velocidad y gradientes de color — todo mediante prompts en lenguaje natural.
create_particles apply_particle_preset set_particle_color_gradient set_particle_materialConecta tu asistente de IA a Godot en menos de 5 minutos.
Copia addons/godot_mcp/ en tu proyecto Godot. Actívalo en Project > Project Settings > Plugins. El plugin inicia un servidor WebSocket dentro del editor automáticamente.
Ejecuta npm install && npm run build en el directorio server/. Esto compila el servidor MCP en TypeScript que conecta tu cliente de IA con el plugin de Godot.
Agrega el servidor a la configuración MCP de tu cliente de IA. Abre Godot, y tu asistente de IA ahora tiene acceso en tiempo real a 163 herramientas — creando escenas, editando scripts, simulando input y analizando tu juego en ejecución.
Todo lo que necesitas para que la IA construya, inspeccione, pruebe y modifique tu proyecto Godot en 2D y 3D.
get_project_info metadata & autoloadsget_filesystem_tree recursive file treesearch_files fuzzy/glob searchget/set_project_settings read & writeuid_to_project_path UID conversionproject_path_to_uid path conversionget_scene_tree live hierarchyget_scene_file_content raw .tscncreate_scene new scenesopen_scene delete_scene save_sceneadd_scene_instance prefab-like instancingplay_scene stop_sceneadd_node delete_node rename_nodeduplicate_node deep copymove_node reparentupdate_property smart type parsingget_node_properties inspect all propsadd_resource shapes, materialsset_anchor_preset UI anchorsconnect_signal disconnect_signallist_scripts project-wide overviewread_script create_scriptedit_script search/replace & insertattach_script attach to nodesget_open_scripts editor awarenessget_editor_errors errors & stack tracesget_editor_screenshot editor viewportget_game_screenshot running gamecompare_screenshots visual diff NEWexecute_editor_script run GDScriptget_signals inspect signal connectionsreload_plugin reload_projectclear_outputsimulate_key keyboard with modifierssimulate_mouse_click positioned clickssimulate_mouse_move absolute/relativesimulate_action Godot InputActionssimulate_sequence multi-event combosget_game_scene_tree live game hierarchyget/set_game_node_properties runtime inspection & tweakingexecute_game_script run code in live gamecapture_frames multi-frame screenshotsmonitor_properties property timelinestart/stop/replay_recording input recording & replay NEWfind_nodes_by_script get_autoloadfind_ui_elements click_button_by_text NEWwait_for_node batch_get_properties NEWlist_animations create_animationadd_animation_track value/position/bezierset_animation_keyframe insert keysget_animation_info tracks & keyframesremove_animationcreate_animation_tree with state machine rootget_animation_tree_structure full tree inspectionadd/remove_state_machine_state manage statesadd/remove_state_machine_transition with conditionsset_blend_tree_node Add2, Blend2, TimeScaleset_tree_parameter conditions & blendstilemap_set_cell place tilestilemap_fill_rect fill regionstilemap_get_cell read tile datatilemap_clear clear alltilemap_get_info tile set sourcestilemap_get_used_cells query used cellsadd_mesh_instance primitives & .glb/.gltf importsetup_lighting sun/indoor/dramatic presetsset_material_3d full PBR material setupsetup_environment sky, fog, glow, SSAO, SSRsetup_camera_3d projection, FOV, cull maskadd_gridmap GridMap with MeshLibrarysetup_collision auto-detect 2D/3D shapesset/get_physics_layers layer & mask managementadd_raycast RayCast2D/3Dsetup_physics_body CharacterBody & RigidBody configget_collision_info full collision auditcreate_particles GPUParticles 2D/3Dset_particle_material direction, velocity, emission shapeset_particle_color_gradient color ramp stopsapply_particle_preset fire, smoke, rain, snow, sparksget_particle_info full config inspectionsetup_navigation_region auto-detect 2D/3Dbake_navigation_mesh mesh baking & polygon gensetup_navigation_agent pathfinding & avoidanceset_navigation_layers layer managementget_navigation_info full nav auditget_audio_bus_layout full bus overviewadd_audio_bus set_audio_bus create & configureadd_audio_bus_effect reverb, delay, compressor, EQadd_audio_player 2D/3D audio playersget_audio_info subtree audio auditcreate_theme new Theme resourceset_theme_color color overridesset_theme_constant constant overridesset_theme_font_size font sizesset_theme_stylebox StyleBoxFlatget_theme_info inspect overridescreate_shader with templatesread_shader edit_shaderassign_shader_material to nodesset_shader_param set uniformsget_shader_params read all paramsread_resource inspect .tres propertiesedit_resource modify & savecreate_resource new .tres of any typefind_nodes_by_type search by classfind_signal_connections audit signalsbatch_set_property bulk changesfind_node_references cross-file searchget_scene_dependencies dependency graphcross_scene_set_property project-wide changes NEWrun_test_scenario automated test sequencesassert_node_state property assertionsassert_screen_text UI text verificationrun_stress_test random input fuzzingget_test_report pass/fail summaryfind_unused_resources dead asset detectionanalyze_signal_flow signal graph mappinganalyze_scene_complexity node count & depthfind_script_references cross-project searchdetect_circular_dependencies cycle detectionget_project_statistics full project overviewget_performance_monitors FPS, memory, physicsget_editor_performance quick summarylist_export_presets configured presetsexport_project build commandsget_export_info paths & templatesFunciones que las alternativas gratuitas no tienen.
Conecta, desconecta e inspecciona señales entre nodos. Ningún competidor ofrece esto. Esencial para la arquitectura orientada a eventos de Godot.
Toda mutación pasa por el sistema UndoRedo de Godot. Ctrl+Z en todo lo que haga la IA. Las alternativas gratuitas modifican escenas directamente sin deshacer.
Vector2(100,200), #ff0000, Color(1,0,0) — la IA envía strings, nosotros los convertimos en tipos nativos de Godot automáticamente.
WebSocket con heartbeat, reconexión automática (backoff exponencial) y escaneo automático de puertos. Sin conexiones perdidas, sin reinicios manuales.
Los errores incluyen códigos estructurados y sugerencias accionables. La IA puede autocorregirse en lugar de quedarse atascada en fallos crípticos.
11 herramientas de nodo: agregar, eliminar, renombrar, duplicar, mover/reparent, actualizar propiedades, agregar recursos, definir anclas. Ningún competidor cubre todo esto.
Deja que la IA juegue tu juego. Simula teclado, mouse e InputActions. Graba sesiones de input y reprodúcelas para pruebas de regresión con temporización precisa por frame.
15 herramientas para inspección en vivo del juego. Lee y modifica propiedades en tiempo real, captura frames, monitorea cambios de propiedades, encuentra elementos de UI, haz clic en botones por texto y espera a que aparezcan nodos.
Crea animaciones, agrega tracks, inserta keyframes. Construye máquinas de estado con transiciones y condiciones. Configura blend trees con nodos Add2, Blend2 y TimeScale.
Agrega meshes (primitivas o .glb/.gltf), configura iluminación con presets, define materiales PBR, crea entornos con cielo/niebla/SSAO/SSR, coloca cámaras y construye GridMaps.
Configura formas de colisión, cuerpos de física, capas de colisión, raycasts. Crea regiones de navegación, genera nav meshes, configura agentes de pathfinding.
Crea sistemas de partículas GPU con presets (fuego, humo, lluvia, nieve). Administra buses de audio, agrega efectos (reverb, delay, compressor) y coloca reproductores de audio 2D/3D.
Crea shaders desde plantillas, edita código GLSL, asigna ShaderMaterials y ajusta uniforms en tiempo real. Flujo completo de shader sin salir del chat con la IA.
Ejecuta escenarios de prueba automatizados con simulación de input y assertions. Verifica texto de UI en pantalla. Pruebas de estrés con input aleatorio. Genera reportes de aprobación/fallo.
Encuentra recursos no utilizados, mapea flujos de señales, analiza complejidad de escenas, detecta dependencias circulares, busca referencias de scripts y obtén estadísticas completas del proyecto.
Encuentra nodos por tipo, audita conexiones de señales, define propiedades masivamente entre escenas, busca en todos los archivos del proyecto y analiza dependencias. Refactoriza a escala.
Ejemplos reales de lo que puedes pedirle a tu asistente de IA — y simplemente funciona.
La IA crea escenas, escribe scripts, conecta señales, configura la UI y ejecuta el juego — todo en una conversación. Mira el video de demostración.
La IA agrega meshes, configura presets de iluminación, define materiales PBR y ajusta configuraciones de entorno — todo a través de la API del editor con deshacer/rehacer completo.
La IA ejecuta el juego, simula input de teclado, captura screenshots, inspecciona propiedades de nodos en tiempo real y verifica el estado del juego — habilitando flujos automatizados de QA.
La IA lee la salida de errores del editor y errores de compilación de scripts, identifica el problema, edita el script para corregirlo y verifica la corrección — un ciclo de retroalimentación rápido sin copiar y pegar mensajes de error.
La IA crea partículas GPU, configura forma de emisión y velocidad, aplica gradientes de color, o usa presets integrados (fuego, humo, lluvia, nieve, chispas) para resultados instantáneos.
La IA busca en todas las escenas, encuentra nodos coincidentes y aplica cambios de propiedades masivamente — tareas que tomarían minutos de clics manuales resueltas en segundos.
Cómo se compara Godot MCP Pro con las alternativas.
| Función | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| Total de Herramientas | 163 | ~30 | 13 |
| Categorías | 23 | ~8 | 4 |
| Conexión | WebSocket + heartbeat | WebSocket | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| Gestión de Señales | Yes | No | No |
| Renombrar/Duplicar/Mover Nodos | Yes | No | No |
| Parsing Inteligente de Tipos | Yes | Limited | No |
| Simulación de Input | Key / Mouse / Action / Sequence | No | No |
| Análisis en Tiempo de Ejecución | 15 herramientas (árbol, props, frames, UI, grabación) | No | No |
| Herramientas de Escena 3D | Mesh, Lighting, PBR, Environment, Camera | No | No |
| Configuración de Física | Collision, Layers, Raycasts, Bodies | No | No |
| Partículas | GPU 2D/3D with presets | No | No |
| Navegación | Region, Mesh baking, Agent | No | No |
| Audio | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| Pruebas Automatizadas | Escenarios, Assertions, Prueba de estrés | No | No |
| Análisis de Código | Recursos no utilizados, Flujo de señales, Complejidad | No | No |
| Screenshots | Editor + Juego + Diff visual | Yes | No |
Preguntas comunes sobre Godot MCP Pro.
Godot MCP Pro es un servidor MCP (Model Context Protocol) premium que conecta asistentes de IA como Claude, Cursor y Cline directamente al editor Godot 4 vía WebSocket. Ofrece 163 herramientas en 23 categorías para manipulación de escenas, animación, modelado 3D, configuración de física, efectos de partículas, gestión de audio, edición de shaders, simulación de input, análisis en tiempo real y pruebas automatizadas.
Instala el plugin Godot MCP Pro en tu proyecto, actívalo en Project Settings > Plugins, compila el servidor MCP con npm install && npm run build, y agrégalo a tu .mcp.json. Claude (Code o Desktop) se conectará automáticamente al editor Godot vía WebSocket y tendrá acceso a las 163 herramientas.
Cualquier cliente de IA compatible con MCP funciona, incluyendo Claude Code, Claude Desktop, Cursor, VS Code con extensión Cline, Windsurf y otras herramientas que soportan el estándar Model Context Protocol. El protocolo MCP es un estándar abierto, así que nuevos clientes se agregan regularmente.
Sí. Godot MCP Pro incluye herramientas 3D dedicadas para agregar meshes primitivas o importar modelos .glb/.gltf, configurar iluminación con presets, definir materiales PBR, crear entornos con cielo/niebla/SSAO/SSR, colocar cámaras y construir GridMaps. Combinado con herramientas de física, navegación y partículas, la IA puede construir escenas completas de juegos 3D.
Sí. La suite de análisis en tiempo de ejecución incluye 15 herramientas que permiten a la IA ejecutar tu juego, simular input de teclado/mouse/acción, capturar screenshots, inspeccionar el árbol de escenas en vivo, leer y modificar propiedades en tiempo real, grabar y reproducir sesiones de input, encontrar elementos de UI, hacer clic en botones por texto y ejecutar escenarios de prueba automatizados con assertions.
Sí. Godot MCP Pro funciona con Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop y cualquier otro cliente compatible con MCP. Configura el servidor MCP en los ajustes de tu editor y se conecta vía WebSocket.
Godot 4.4 o posterior (probado en Godot 4.6) y Node.js 18+. Funciona en Windows, macOS y Linux.
Godot MCP Pro ofrece 163 herramientas comparado con 13-32 en las alternativas gratuitas. Las funciones exclusivas incluyen deshacer/rehacer completo, gestión de señales, simulación de input con grabación/reproducción, suite de análisis en tiempo real con 15 herramientas, construcción de escenas 3D, configuración de física, sistemas de partículas, gestión de buses de audio, herramientas de nav mesh, máquinas de estado AnimationTree, pruebas automatizadas y análisis de código.
Sí. El plugin GDScript del editor (addons/godot_mcp/) es completamente open source y está disponible en GitHub. Puedes inspeccionar exactamente cómo el plugin se comunica con el editor antes de comprar. El servidor MCP (TypeScript) está incluido en la descarga de pago.
No. Godot MCP Pro es una compra única de $5 con actualizaciones de por vida para v1.x, proyectos ilimitados, máquinas ilimitadas y soporte por Discord. Sin cuotas recurrentes, sin límite de licencias.
Empieza a usarlo en menos de 5 minutos.
Copia la carpeta addons/godot_mcp/ de la descarga al directorio raíz de tu proyecto Godot. Luego activa el plugin:
Project > Project Settings > Plugins > Godot MCP Pro > Enable
Abre una terminal en el directorio server/:
cd server npm install npm run build
Agrega el servidor al archivo de configuración MCP de tu cliente de IA (ej.: .mcp.json para Claude Code):
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
Abre tu proyecto Godot con el plugin activado. El panel de estado en el dock del editor muestra el estado de la conexión. Inicia tu asistente de IA y empieza a crear — ahora tiene acceso directo a 163 herramientas en tu editor Godot.
Paga una vez, usa para siempre. Actualizaciones de por vida para v1.x incluidas.