Il server MCP n°1 per Godot Engine

Crea giochi Godot
con i superpoteri dell'AI

Godot MCP Pro è un server MCP con 175 strumenti che collega assistenti AI come Claude e Cursor direttamente all'editor Godot 4 tramite WebSocket. Consente all'AI di creare scene, scrivere GDScript, simulare l'input del giocatore, ispezionare i giochi in esecuzione, costruire ambienti 3D, configurare la fisica, gestire particelle e audio — tutto da un'unica conversazione. Acquisto una tantum di $15, funziona su Windows, macOS e Linux.

Acquisto una tantum di $15 · Aggiornamenti a vita

Guardalo in azione

Un prompt → l'AI costruisce un gioco di Reversi completo, lo avvia e lo collauda con i clic del mouse.

Guarda la demo completa su YouTube →
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor

Comunicazione bidirezionale in tempo reale. Nessun polling dei file. Nessuna generazione di sottoprocessi CLI. Solo feedback istantaneo.

Guide & Tutorial

Guide pratiche per Godot 4 potenziate dall'AI. Nessuna informazione obsoleta su Godot 3 — tutto qui è testato su Godot 4.4+.

Collega l'AI a Godot 4

Configura MCP Pro in 5 minuti e lascia che Claude o Cursor controllino direttamente il tuo editor Godot. Installa il plugin, compila il server, configura il tuo client AI — e sei pronto.

"Recupera le informazioni del progetto e mostrami l'albero della scena"
Principiante ~5 min
Utilizza: get_project_info get_scene_tree
🎮

Crea un gioco 2D da zero

Chiedi all'AI di creare un gioco 2D completo — scene, script, segnali, UI. Questa guida ti accompagna nella costruzione di un gioco da tavolo di Reversi in un'unica conversazione con l'AI, da un progetto vuoto a un gioco giocabile.

"Crea un gioco di Reversi con una scacchiera 8x8, posizionamento con clic, avversario AI e visualizzazione del punteggio"
Principiante ~15 min
Utilizza: create_scene add_node create_script connect_signal play_scene
🧑

Controller di personaggio 3D

Costruisci un controller di personaggio in terza persona con animazioni Mixamo, macchina a stati AnimationTree, telecamera SpringArm3D e terreno — tutto creato dall'AI. Copre CharacterBody3D, i layer di fisica e il blending delle animazioni in Godot 4.

"Crea una scena 3D con terreno, un personaggio che usa x_bot.fbx con animazioni di camminata/corsa/salto e una telecamera che lo segue"
Intermedio ~20 min
Utilizza: add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3d
🔌

Pattern dei segnali in Godot 4

Godot 4 ha rivoluzionato i segnali rispetto a Godot 3. Niente più connect("signal", obj, "method") — usa signal.connect(callable). Lascia che l'AI verifichi l'architettura dei tuoi segnali, individui i segnali scollegati e visualizzi il flusso dei segnali in tutto il progetto.

"Analizza il flusso dei segnali nel mio progetto e trova eventuali segnali scollegati"
Intermedio ~10 min
Utilizza: analyze_signal_flow find_signal_connections get_signals connect_signal
🤖

Testing automatizzato dei giochi

Lascia che l'AI collaudi il tuo gioco. Avvia il gioco, simula l'input di tastiera/mouse, cattura screenshot, verifica lo stato del gioco ed esegui stress test con input casuali. Nessun framework di test richiesto — MCP Pro gestisce tutto a livello di editor.

"Avvia il gioco, cammina a destra per 2 secondi, salta, poi verifica che il giocatore abbia raggiunto la piattaforma"
Intermedio ~10 min
Utilizza: play_scene simulate_key capture_frames assert_node_state run_stress_test
🎬

Macchine a stati AnimationTree

L'AnimationTree di Godot 4 è potente ma complesso. Lascia che l'AI crei macchine a stati con transizioni, configuri blend tree, imposti condizioni e colleghi i parametri — l'ostacolo più comune per i principianti di Godot, risolto in pochi minuti.

"Crea un AnimationTree con gli stati Idle, Walk, Run e Jump con le transizioni appropriate"
Avanzato ~15 min
Utilizza: create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameter
💥

Configurazione di fisica & collisioni

Godot 4 ha rinominato PhysicsBody in CharacterBody/RigidBody e ha modificato le API dei collision layer. Lascia che l'AI configuri le forme di collisione, imposti correttamente i layer di fisica, aggiunga raycast e verifichi la tua configurazione delle collisioni — evitando i bug di fisica più comuni.

"Configura le collisioni per tutti i nodi CharacterBody2D e organizza i layer di fisica per tipo (giocatore, nemico, ambiente)"
Intermedio ~10 min
Utilizza: setup_collision set_physics_layers setup_physics_body get_collision_info

Ricettario di effetti particellari

Godot 4 ha sostituito i CPUParticles predefiniti con GPUParticles2D/3D. Crea fuoco, fumo, pioggia, neve e scintille con preset integrati, oppure regola con precisione la forma di emissione, le curve di velocità e i gradienti di colore — il tutto tramite prompt in linguaggio naturale.

"Aggiungi particelle di fuoco alla torcia con un gradiente dall'arancione al rosso e applica il preset del fuoco"
Principiante ~5 min
Utilizza: create_particles apply_particle_preset set_particle_color_gradient set_particle_material

Come funziona

Collega il tuo assistente AI a Godot in meno di 5 minuti.

Installa il plugin

Copia addons/godot_mcp/ nel tuo progetto Godot. Abilitalo in Progetto > Impostazioni progetto > Plugin. Il plugin avvia automaticamente un server WebSocket all'interno dell'editor.

Compila il server MCP

Esegui npm install && npm run build nella directory server/. Questo compila il server MCP TypeScript che collega il tuo client AI al plugin Godot.

Inizia a sviluppare con l'AI

Aggiungi il server alla configurazione MCP del tuo client AI. Apri Godot e il tuo assistente AI avrà accesso in tempo reale a 175 strumenti — creazione di scene, modifica di script, simulazione degli input e analisi del gioco in esecuzione.

175
Strumenti
23
Categorie
16
Categorie esclusive
(che nessun concorrente ha)
Annulla/Ripeti
su tutte le modifiche

175 strumenti, 23 categorie

Tutto ciò che serve per lasciare che l'AI costruisca, ispezioni, testi e modifichi il tuo progetto Godot in 2D e 3D.

Project

7 tools
  • get_project_info metadata & autoloads
  • get_filesystem_tree recursive file tree
  • search_files fuzzy/glob search
  • get/set_project_settings read & write
  • uid_to_project_path UID conversion
  • project_path_to_uid path conversion

Scene

9 tools
  • get_scene_tree live hierarchy
  • get_scene_file_content raw .tscn
  • create_scene new scenes
  • open_scene delete_scene save_scene
  • add_scene_instance prefab-like instancing
  • play_scene stop_scene

Node

11 tools
  • add_node delete_node rename_node
  • duplicate_node deep copy
  • move_node reparent
  • update_property smart type parsing
  • get_node_properties inspect all props
  • add_resource shapes, materials
  • set_anchor_preset UI anchors
  • connect_signal disconnect_signal

Script

6 tools
  • list_scripts project-wide overview
  • read_script create_script
  • edit_script search/replace & insert
  • attach_script attach to nodes
  • get_open_scripts editor awareness

Editor

9 tools
  • get_editor_errors errors & stack traces
  • get_editor_screenshot editor viewport
  • get_game_screenshot running game
  • compare_screenshots visual diff NEW
  • execute_editor_script run GDScript
  • get_signals inspect signal connections
  • reload_plugin reload_project
  • clear_output

Input Simulation

5 tools
  • simulate_key keyboard with modifiers
  • simulate_mouse_click positioned clicks
  • simulate_mouse_move absolute/relative
  • simulate_action Godot InputActions
  • simulate_sequence multi-event combos

Runtime Analysis

15 tools
  • get_game_scene_tree live game hierarchy
  • get/set_game_node_properties runtime inspection & tweaking
  • execute_game_script run code in live game
  • capture_frames multi-frame screenshots
  • monitor_properties property timeline
  • start/stop/replay_recording input recording & replay NEW
  • find_nodes_by_script get_autoload
  • find_ui_elements click_button_by_text NEW
  • wait_for_node batch_get_properties NEW

Animation

6 tools
  • list_animations create_animation
  • add_animation_track value/position/bezier
  • set_animation_keyframe insert keys
  • get_animation_info tracks & keyframes
  • remove_animation

AnimationTree NEW

8 tools
  • create_animation_tree with state machine root
  • get_animation_tree_structure full tree inspection
  • add/remove_state_machine_state manage states
  • add/remove_state_machine_transition with conditions
  • set_blend_tree_node Add2, Blend2, TimeScale
  • set_tree_parameter conditions & blends

TileMap

6 tools
  • tilemap_set_cell place tiles
  • tilemap_fill_rect fill regions
  • tilemap_get_cell read tile data
  • tilemap_clear clear all
  • tilemap_get_info tile set sources
  • tilemap_get_used_cells query used cells

3D Scene NEW

6 tools
  • add_mesh_instance primitives & .glb/.gltf import
  • setup_lighting sun/indoor/dramatic presets
  • set_material_3d full PBR material setup
  • setup_environment sky, fog, glow, SSAO, SSR
  • setup_camera_3d projection, FOV, cull mask
  • add_gridmap GridMap with MeshLibrary

Physics NEW

6 tools
  • setup_collision auto-detect 2D/3D shapes
  • set/get_physics_layers layer & mask management
  • add_raycast RayCast2D/3D
  • setup_physics_body CharacterBody & RigidBody config
  • get_collision_info full collision audit

Particles NEW

5 tools
  • create_particles GPUParticles 2D/3D
  • set_particle_material direction, velocity, emission shape
  • set_particle_color_gradient color ramp stops
  • apply_particle_preset fire, smoke, rain, snow, sparks
  • get_particle_info full config inspection

Navigation NEW

5 tools
  • setup_navigation_region auto-detect 2D/3D
  • bake_navigation_mesh mesh baking & polygon gen
  • setup_navigation_agent pathfinding & avoidance
  • set_navigation_layers layer management
  • get_navigation_info full nav audit

Audio NEW

6 tools
  • get_audio_bus_layout full bus overview
  • add_audio_bus set_audio_bus create & configure
  • add_audio_bus_effect reverb, delay, compressor, EQ
  • add_audio_player 2D/3D audio players
  • get_audio_info subtree audio audit

Theme & UI

6 tools
  • create_theme new Theme resource
  • set_theme_color color overrides
  • set_theme_constant constant overrides
  • set_theme_font_size font sizes
  • set_theme_stylebox StyleBoxFlat
  • get_theme_info inspect overrides

Shader

6 tools
  • create_shader with templates
  • read_shader edit_shader
  • assign_shader_material to nodes
  • set_shader_param set uniforms
  • get_shader_params read all params

Resource NEW

3 tools
  • read_resource inspect .tres properties
  • edit_resource modify & save
  • create_resource new .tres of any type

Batch & Refactoring

6 tools
  • find_nodes_by_type search by class
  • find_signal_connections audit signals
  • batch_set_property bulk changes
  • find_node_references cross-file search
  • get_scene_dependencies dependency graph
  • cross_scene_set_property project-wide changes NEW

Testing & QA NEW

5 tools
  • run_test_scenario automated test sequences
  • assert_node_state property assertions
  • assert_screen_text UI text verification
  • run_stress_test random input fuzzing
  • get_test_report pass/fail summary

Code Analysis NEW

6 tools
  • find_unused_resources dead asset detection
  • analyze_signal_flow signal graph mapping
  • analyze_scene_complexity node count & depth
  • find_script_references cross-project search
  • detect_circular_dependencies cycle detection
  • get_project_statistics full project overview

Profiling

2 tools
  • get_performance_monitors FPS, memory, physics
  • get_editor_performance quick summary

Export

3 tools
  • list_export_presets configured presets
  • export_project build commands
  • get_export_info paths & templates

Perché Pro?

Funzionalità che le alternative gratuite non hanno.

Gestione dei segnali

Collega, scollega e ispeziona i segnali tra i nodi. Nessun concorrente lo supporta. Essenziale per l'architettura event-driven di Godot.

Annulla/Ripeti completo

Ogni modifica passa attraverso il sistema UndoRedo di Godot. Annulla con Ctrl+Z tutto ciò che fa l'AI. Le alternative gratuite modificano le scene direttamente, senza possibilità di annullamento.

Parsing intelligente dei tipi

Vector2(100,200), #ff0000, Color(1,0,0) — l'AI invia stringhe e noi le convertiamo automaticamente nei tipi Godot appropriati.

Connessione di livello produzione

WebSocket con heartbeat, riconnessione automatica (backoff esponenziale) e scansione automatica delle porte. Nessuna connessione interrotta, nessun riavvio manuale.

Suggerimenti contestuali sugli errori

Gli errori includono codici strutturati e suggerimenti pratici. L'AI può autocorreggersi invece di bloccarsi su errori criptici.

Operazioni complete sui nodi

11 strumenti per i nodi: aggiungi, elimina, rinomina, duplica, sposta/riassegna il genitore, aggiorna le proprietà, aggiungi risorse, imposta gli ancoraggi. Nessun concorrente li copre tutti.

Simulazione & registrazione degli input

Lascia che l'AI giochi al tuo gioco. Simula tastiera, mouse e InputActions. Registra le sessioni di input e riproducile per i test di regressione con timing preciso al frame.

Analisi a runtime

15 strumenti per l'ispezione del gioco dal vivo. Leggi e modifica le proprietà a runtime, cattura frame, monitora le modifiche alle proprietà, trova gli elementi dell'UI, clicca i pulsanti per testo e attendi la comparsa dei nodi.

Animazione & AnimationTree

Crea animazioni, aggiungi tracce, inserisci keyframe. Costruisci macchine a stati con transizioni e condizioni. Configura blend tree con i nodi Add2, Blend2 e TimeScale.

Costruzione di scene 3D

Aggiungi mesh (primitive o .glb/.gltf), configura l'illuminazione con preset, imposta materiali PBR, crea ambienti con cielo/nebbia/SSAO/SSR, posiziona telecamere e costruisci GridMap.

Fisica & navigazione

Configura forme di collisione, imposta corpi fisici, gestisci i collision layer, aggiungi raycast. Crea regioni di navigazione, esegui il baking delle nav mesh, configura gli agenti di pathfinding.

Particelle & audio

Crea sistemi di particelle GPU con preset (fuoco, fumo, pioggia, neve). Gestisci i bus audio, aggiungi effetti (riverbero, delay, compressore) e posiziona player audio 2D/3D.

Pipeline degli shader

Crea shader da template, modifica il codice GLSL, assegna ShaderMaterial e regola gli uniform a runtime. Flusso di lavoro completo per gli shader senza uscire dalla chat con l'AI.

Testing & QA

Esegui scenari di test automatizzati con simulazione degli input e asserzioni. Verifica il testo dell'UI sullo schermo. Esegui stress test con fuzzing di input casuali. Genera report di test con esito superato/fallito.

Analisi del codice

Trova risorse inutilizzate, mappa i flussi dei segnali, analizza la complessità delle scene, rileva le dipendenze circolari, cerca i riferimenti negli script e ottieni statistiche complete del progetto.

Operazioni in batch

Trova nodi per tipo, verifica le connessioni dei segnali, imposta proprietà in blocco tra le scene, cerca in tutti i file del progetto e analizza le dipendenze. Refactoring su larga scala.

Cosa può fare l'AI nel tuo progetto Godot?

Esempi reali di ciò che puoi chiedere al tuo assistente AI di fare — e funziona e basta.

Costruisci un gioco completo da zero

"Crea un gioco da tavolo di Reversi con una griglia 8x8, meccanica di posizionamento con clic, avversario AI e visualizzazione del punteggio."

L'AI crea scene, scrive script, collega segnali, configura l'UI ed esegue il gioco — tutto in un'unica conversazione. Guarda il video demo.

Utilizza: create_scene add_node create_script connect_signal play_scene

Configura un ambiente 3D

"Aggiungi una mesh del terreno, configura un'illuminazione drammatica con ombre, imposta materiali PBR con roughness 0.3 e aggiungi nebbia con densità volumetrica 0.02."

L'AI aggiunge mesh, configura preset di illuminazione, imposta materiali PBR e regola le impostazioni dell'ambiente — tutto tramite l'API dell'editor con annullamento/ripetizione completi.

Utilizza: add_mesh_instance setup_lighting set_material_3d setup_environment

Collaudo automatizzato

"Avvia il gioco, fai camminare il personaggio a destra per 2 secondi, fallo saltare, poi controlla se il giocatore ha raggiunto la piattaforma."

L'AI avvia il gioco, simula l'input da tastiera, cattura screenshot, ispeziona le proprietà dei nodi a runtime e verifica lo stato del gioco — abilitando flussi di lavoro di QA automatizzati.

Utilizza: play_scene simulate_key get_game_screenshot get_game_node_properties assert_node_state

Esegui il debug degli errori GDScript

"Controlla la presenza di errori nell'editor e correggili."

L'AI legge l'output degli errori dell'editor e gli errori di compilazione degli script, individua il problema, modifica lo script per correggerlo e verifica la correzione — un ciclo di feedback stretto senza copiare e incollare i messaggi di errore.

Utilizza: get_editor_errors read_script edit_script get_editor_errors

Aggiungi effetti particellari

"Aggiungi particelle di fuoco al nodo torcia con un gradiente dall'arancione al rosso e velocità verso l'alto."

L'AI crea particelle GPU, configura la forma di emissione e la velocità, applica gradienti di colore, oppure usa preset integrati (fuoco, fumo, pioggia, neve, scintille) per risultati istantanei.

Utilizza: create_particles set_particle_material set_particle_color_gradient

Refactoring tra le scene

"Trova tutti i nodi CharacterBody2D nel progetto e imposta il loro floor_snap_length a 8."

L'AI cerca in tutte le scene, individua i nodi corrispondenti e applica modifiche di proprietà in blocco — attività che richiederebbero minuti di clic manuali svolte in pochi secondi.

Utilizza: find_nodes_by_type batch_set_property cross_scene_set_property

Confronto

Come si posiziona Godot MCP Pro rispetto alle alternative.

Funzionalità Godot MCP Pro GDAI MCP ($19) godot-mcp (free)
Strumenti totali175~3013
Categorie23~84
ConnessioneWebSocket + heartbeatstdio (Python)Headless CLI
Undo/RedoYesYesNo
Gestione dei segnaliYesNoNo
Rinomina/Duplica/Sposta nodiYesNoNo
Parsing intelligente dei tipiYesLimitedNo
Simulazione degli inputKey / Mouse / Action / SequenceYes (basic)No
Analisi a runtime15 strumenti (albero, proprietà, frame, UI, registrazione)NoNo
Strumenti per scene 3DMesh, Lighting, PBR, Environment, CameraNoNo
Configurazione della fisicaCollision, Layers, Raycasts, BodiesNoNo
ParticelleGPU 2D/3D with presetsNoNo
NavigazioneRegion, Mesh baking, AgentNoNo
AudioBuses, Effects, PlayersNoNo
AnimationTreeState machine, Blend treeNoNo
Testing automatizzatoScenari, asserzioni, stress testNoNo
Analisi del codiceRisorse inutilizzate, flusso dei segnali, complessitàNoNo
ScreenshotEditor + Gioco + Diff visivoYesNo

Vedi il confronto completo e la guida all’acquisto →

Domande frequenti

Domande comuni su Godot MCP Pro.

Cos'è Godot MCP Pro?

Godot MCP Pro è un server MCP (Model Context Protocol) premium che collega assistenti AI come Claude, Cursor e Cline direttamente all'editor Godot 4 tramite WebSocket. Fornisce 175 strumenti in 23 categorie per la manipolazione delle scene, l'animazione, la modellazione 3D, la configurazione della fisica, gli effetti particellari, la gestione dell'audio, la modifica degli shader, la simulazione degli input, l'analisi a runtime e il testing automatizzato.

Come collego Claude a Godot?

Installa il plugin Godot MCP Pro nel tuo progetto, abilitalo in Impostazioni progetto > Plugin, compila il server MCP con npm install && npm run build e aggiungilo al tuo .mcp.json. Claude (Code o Desktop) si connetterà automaticamente all'editor Godot tramite WebSocket e avrà accesso a tutti i 175 strumenti.

Quali assistenti AI funzionano con Godot MCP Pro?

Funziona qualsiasi client AI compatibile con MCP, inclusi Claude Code, Claude Desktop, Cursor, VS Code con l'estensione Cline, Windsurf e altri strumenti che supportano lo standard Model Context Protocol. Il protocollo MCP è uno standard aperto, quindi nuovi client vengono aggiunti regolarmente.

L'AI può creare giochi 3D in Godot?

Sì. Godot MCP Pro include strumenti 3D dedicati per aggiungere primitive mesh o importare modelli .glb/.gltf, configurare l'illuminazione con preset, impostare materiali PBR, creare ambienti con cielo/nebbia/SSAO/SSR, posizionare telecamere e costruire GridMap. Combinato con gli strumenti di fisica, navigazione e particelle, l'AI può costruire scene di gioco 3D complete.

L'AI può collaudare il mio gioco?

Sì. La suite di analisi a runtime include 15 strumenti che permettono all'AI di avviare il tuo gioco, simulare input di tastiera/mouse/azione, catturare screenshot, ispezionare l'albero della scena dal vivo, leggere e modificare le proprietà a runtime, registrare e riprodurre le sessioni di input, trovare gli elementi dell'UI, cliccare i pulsanti per testo ed eseguire scenari di test automatizzati con asserzioni.

Funziona con Cursor?

Sì. Godot MCP Pro funziona con Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop e qualsiasi altro client compatibile con MCP. Configura il server MCP nelle impostazioni del tuo editor e si connette tramite WebSocket.

Quale versione di Godot è richiesta?

Godot 4.4 o successivo (testato su Godot 4.6) e Node.js 18+. Funziona su Windows, macOS e Linux.

Come si confronta con le alternative gratuite?

Godot MCP Pro offre 175 strumenti rispetto ai 13-32 delle alternative gratuite. Le funzionalità esclusive includono annullamento/ripetizione completi, gestione dei segnali, simulazione degli input con registrazione/riproduzione, suite di analisi a runtime con 15 strumenti, costruzione di scene 3D, configurazione della fisica, sistemi di particelle, gestione dei bus audio, strumenti per le nav mesh, macchine a stati AnimationTree, testing automatizzato e analisi del codice.

Il codice sorgente del plugin è disponibile?

Sì. Il plugin dell'editor GDScript (addons/godot_mcp/) è completamente open source e disponibile su GitHub. Puoi verificare esattamente come il plugin comunica con l'editor prima dell'acquisto. Il server MCP (TypeScript) è incluso nel download a pagamento.

C'è un abbonamento?

No. Godot MCP Pro è un acquisto una tantum di $15 con aggiornamenti a vita, progetti illimitati, macchine illimitate e supporto Discord. Nessun costo ricorrente, nessun limite di postazioni.

Guida rapida alla configurazione

Operativo in meno di 5 minuti.

1. Installa il plugin Godot

Copia la cartella addons/godot_mcp/ dal download nella directory principale del tuo progetto Godot. Poi abilita il plugin:

Project > Project Settings > Plugins > Godot MCP Pro > Enable

2. Compila il server MCP

Apri un terminale nella directory server/:

cd server
npm install
npm run build

3. Configura il tuo client AI

Aggiungi il server al file di configurazione MCP del tuo client AI (ad es. .mcp.json per Claude Code):

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}

4. Inizia a usarlo

Apri il tuo progetto Godot con il plugin abilitato. Il pannello di stato nel dock dell'editor mostra lo stato della connessione. Avvia il tuo assistente AI e inizia a sviluppare — ora ha accesso diretto a 175 strumenti nel tuo editor Godot.

Prezzo semplice, una tantum

Paga una volta, usa per sempre. Aggiornamenti a vita inclusi.

$15
Pagamento una tantum
  • ✓ Tutti i 175 strumenti in 23 categorie
  • ✓ Supporto 2D e 3D
  • ✓ Aggiornamenti a vita
  • ✓ Progetti illimitati
  • ✓ Macchine illimitate
  • ✓ Canale di supporto Discord
Acquista su itch.io Buy Me a Coffee Domande? Unisciti al nostro Discord