Godot MCP Pro é um servidor MCP com 163 ferramentas que conecta assistentes de IA como Claude e Cursor diretamente ao editor Godot 4 via WebSocket. Permite que a IA crie cenas, escreva GDScript, simule input do jogador, inspecione jogos em execução, construa ambientes 3D, configure física, gerencie partículas e áudio — tudo em uma única conversa. $5 pagamento único, funciona no Windows, macOS e Linux.
$5 pagamento único · Atualizações vitalíciasUm prompt → a IA constrói um jogo completo de Reversi, executa e testa com cliques do mouse.
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
Comunicação bidirecional em tempo real. Sem polling de arquivos. Sem subprocessos CLI. Apenas feedback instantâneo.
Guias práticos para Godot 4 com IA. Sem informações desatualizadas do Godot 3 — tudo aqui foi testado no Godot 4.4+.
Configure o MCP Pro em 5 minutos e deixe Claude ou Cursor controlarem diretamente seu editor Godot. Instale o plugin, compile o servidor, configure seu cliente de IA — e está pronto.
get_project_info get_scene_treePeça para a IA criar um jogo 2D completo — cenas, scripts, sinais, UI. Este guia mostra como construir um jogo de Reversi em uma única conversa com IA, de projeto vazio a jogo jogável.
create_scene add_node create_script connect_signal play_sceneConstrua um controlador de personagem em terceira pessoa com animações Mixamo, máquina de estados AnimationTree, câmera SpringArm3D e terreno — tudo criado pela IA. Cobre CharacterBody3D, camadas de física e blending de animação no Godot 4.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dO Godot 4 reformulou os sinais do Godot 3. Sem mais connect("signal", obj, "method") — use signal.connect(callable). Deixe a IA auditar sua arquitetura de sinais, encontrar sinais desconectados e visualizar o fluxo de sinais no seu projeto.
analyze_signal_flow find_signal_connections get_signals connect_signalDeixe a IA testar seu jogo. Execute o jogo, simule input de teclado/mouse, capture screenshots, verifique o estado do jogo e execute testes de estresse com input aleatório. Sem necessidade de framework de testes — o MCP Pro resolve tudo no nível do editor.
play_scene simulate_key capture_frames assert_node_state run_stress_testO AnimationTree do Godot 4 é poderoso, mas complexo. Deixe a IA criar máquinas de estado com transições, configurar blend trees, definir condições e conectar parâmetros — o obstáculo mais comum para iniciantes no Godot, resolvido em minutos.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterO Godot 4 renomeou PhysicsBody para CharacterBody/RigidBody e mudou as APIs de camadas de colisão. Deixe a IA configurar formas de colisão, definir camadas de física corretamente, adicionar raycasts e auditar sua configuração de colisão — evitando os bugs de física mais comuns.
setup_collision set_physics_layers setup_physics_body get_collision_infoO Godot 4 substituiu o padrão CPUParticles por GPUParticles2D/3D. Crie fogo, fumaça, chuva, neve e faíscas com presets integrados, ou ajuste forma de emissão, curvas de velocidade e gradientes de cor — tudo através de prompts em linguagem natural.
create_particles apply_particle_preset set_particle_color_gradient set_particle_materialConecte seu assistente de IA ao Godot em menos de 5 minutos.
Copie addons/godot_mcp/ para seu projeto Godot. Ative em Project > Project Settings > Plugins. O plugin inicia um servidor WebSocket dentro do editor automaticamente.
Execute npm install && npm run build no diretório server/. Isso compila o servidor MCP em TypeScript que conecta seu cliente de IA ao plugin do Godot.
Adicione o servidor à configuração MCP do seu cliente de IA. Abra o Godot, e seu assistente de IA agora tem acesso em tempo real a 163 ferramentas — criando cenas, editando scripts, simulando input e analisando seu jogo em execução.
Tudo que você precisa para a IA construir, inspecionar, testar e modificar seu projeto Godot em 2D e 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 & templatesRecursos que as alternativas gratuitas não possuem.
Conecte, desconecte e inspecione sinais entre nós. Nenhum concorrente oferece isso. Essencial para a arquitetura orientada a eventos do Godot.
Toda mutação passa pelo sistema UndoRedo do Godot. Ctrl+Z em tudo que a IA fizer. Alternativas gratuitas modificam cenas diretamente sem desfazer.
Vector2(100,200), #ff0000, Color(1,0,0) — a IA envia strings, nós convertemos em tipos nativos do Godot automaticamente.
WebSocket com heartbeat, reconexão automática (backoff exponencial) e varredura automática de portas. Sem conexões perdidas, sem reinicializações manuais.
Erros incluem códigos estruturados e sugestões acionáveis. A IA pode se autocorrigir em vez de ficar presa em falhas enigmáticas.
11 ferramentas de nó: adicionar, excluir, renomear, duplicar, mover/reparent, atualizar propriedades, adicionar recursos, definir âncoras. Nenhum concorrente cobre tudo isso.
Deixe a IA jogar seu jogo. Simule teclado, mouse e InputActions. Grave sessões de input e reproduza para testes de regressão com temporização precisa por frame.
15 ferramentas para inspeção ao vivo do jogo. Leia e modifique propriedades em tempo real, capture frames, monitore mudanças de propriedades, encontre elementos de UI, clique em botões por texto e aguarde nós aparecerem.
Crie animações, adicione tracks, insira keyframes. Construa máquinas de estado com transições e condições. Configure blend trees com nós Add2, Blend2 e TimeScale.
Adicione meshes (primitivas ou .glb/.gltf), configure iluminação com presets, defina materiais PBR, crie ambientes com céu/neblina/SSAO/SSR, posicione câmeras e construa GridMaps.
Configure formas de colisão, corpos de física, camadas de colisão, raycasts. Crie regiões de navegação, gere nav meshes, configure agentes de pathfinding.
Crie sistemas de partículas GPU com presets (fogo, fumaça, chuva, neve). Gerencie buses de áudio, adicione efeitos (reverb, delay, compressor) e posicione players de áudio 2D/3D.
Crie shaders a partir de templates, edite código GLSL, atribua ShaderMaterials e ajuste uniforms em tempo real. Fluxo completo de shader sem sair do chat com a IA.
Execute cenários de teste automatizados com simulação de input e assertions. Verifique texto de UI na tela. Teste de estresse com input aleatório. Gere relatórios de aprovação/reprovação.
Encontre recursos não utilizados, mapeie fluxos de sinais, analise complexidade de cenas, detecte dependências circulares, pesquise referências de scripts e obtenha estatísticas completas do projeto.
Encontre nós por tipo, audite conexões de sinais, defina propriedades em massa entre cenas, pesquise em todos os arquivos do projeto e analise dependências. Refatore em escala.
Exemplos reais do que você pode pedir ao seu assistente de IA — e simplesmente funciona.
A IA cria cenas, escreve scripts, conecta sinais, configura a UI e executa o jogo — tudo em uma conversa. Assista ao vídeo de demonstração.
A IA adiciona meshes, configura presets de iluminação, define materiais PBR e ajusta configurações de ambiente — tudo pela API do editor com desfazer/refazer completo.
A IA executa o jogo, simula input de teclado, captura screenshots, inspeciona propriedades dos nós em tempo real e verifica o estado do jogo — habilitando fluxos automatizados de QA.
A IA lê a saída de erros do editor e erros de compilação de scripts, identifica o problema, edita o script para corrigi-lo e verifica a correção — um ciclo de feedback rápido sem copiar e colar mensagens de erro.
A IA cria partículas GPU, configura forma de emissão e velocidade, aplica gradientes de cor, ou usa presets integrados (fogo, fumaça, chuva, neve, faíscas) para resultados instantâneos.
A IA pesquisa em todas as cenas, encontra nós correspondentes e aplica alterações de propriedades em massa — tarefas que levariam minutos de cliques manuais resolvidas em segundos.
Como o Godot MCP Pro se compara às alternativas.
| Recurso | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| Total de Ferramentas | 163 | ~30 | 13 |
| Categorias | 23 | ~8 | 4 |
| Conexão | WebSocket + heartbeat | WebSocket | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| Gerenciamento de Sinais | Yes | No | No |
| Renomear/Duplicar/Mover Nós | Yes | No | No |
| Parsing Inteligente de Tipos | Yes | Limited | No |
| Simulação de Input | Key / Mouse / Action / Sequence | No | No |
| Análise em Tempo de Execução | 15 ferramentas (árvore, props, frames, UI, gravação) | No | No |
| Ferramentas de Cena 3D | Mesh, Lighting, PBR, Environment, Camera | No | No |
| Configuração de Física | Collision, Layers, Raycasts, Bodies | No | No |
| Partículas | GPU 2D/3D with presets | No | No |
| Navegação | Region, Mesh baking, Agent | No | No |
| Áudio | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| Testes Automatizados | Cenários, Assertions, Teste de estresse | No | No |
| Análise de Código | Recursos não utilizados, Fluxo de sinais, Complexidade | No | No |
| Screenshots | Editor + Jogo + Diff visual | Yes | No |
Perguntas comuns sobre o Godot MCP Pro.
Godot MCP Pro é um servidor MCP (Model Context Protocol) premium que conecta assistentes de IA como Claude, Cursor e Cline diretamente ao editor Godot 4 via WebSocket. Ele oferece 163 ferramentas em 23 categorias para manipulação de cenas, animação, modelagem 3D, configuração de física, efeitos de partículas, gerenciamento de áudio, edição de shaders, simulação de input, análise em tempo real e testes automatizados.
Instale o plugin Godot MCP Pro no seu projeto, ative-o em Project Settings > Plugins, compile o servidor MCP com npm install && npm run build, e adicione-o ao seu .mcp.json. O Claude (Code ou Desktop) se conectará automaticamente ao editor Godot via WebSocket e terá acesso a todas as 163 ferramentas.
Qualquer cliente de IA compatível com MCP funciona, incluindo Claude Code, Claude Desktop, Cursor, VS Code com extensão Cline, Windsurf e outras ferramentas que suportam o padrão Model Context Protocol. O protocolo MCP é um padrão aberto, então novos clientes são adicionados regularmente.
Sim. O Godot MCP Pro inclui ferramentas 3D dedicadas para adicionar meshes primitivas ou importar modelos .glb/.gltf, configurar iluminação com presets, definir materiais PBR, criar ambientes com céu/neblina/SSAO/SSR, posicionar câmeras e construir GridMaps. Combinado com ferramentas de física, navegação e partículas, a IA pode construir cenas completas de jogos 3D.
Sim. A suíte de análise em tempo de execução inclui 15 ferramentas que permitem à IA executar seu jogo, simular input de teclado/mouse/ação, capturar screenshots, inspecionar a árvore de cena ao vivo, ler e modificar propriedades em tempo real, gravar e reproduzir sessões de input, encontrar elementos de UI, clicar em botões por texto e executar cenários de teste automatizados com assertions.
Sim. O Godot MCP Pro funciona com Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop e qualquer outro cliente compatível com MCP. Configure o servidor MCP nas configurações do seu editor e ele se conecta via WebSocket.
Godot 4.4 ou posterior (testado no Godot 4.6) e Node.js 18+. Funciona no Windows, macOS e Linux.
O Godot MCP Pro oferece 163 ferramentas comparado a 13-32 nas alternativas gratuitas. Recursos exclusivos incluem desfazer/refazer completo, gerenciamento de sinais, simulação de input com gravação/reprodução, suíte de análise em tempo real com 15 ferramentas, construção de cenas 3D, configuração de física, sistemas de partículas, gerenciamento de buses de áudio, ferramentas de nav mesh, máquinas de estado AnimationTree, testes automatizados e análise de código.
Sim. O plugin GDScript do editor (addons/godot_mcp/) é totalmente open source e está disponível no GitHub. Você pode inspecionar exatamente como o plugin se comunica com o editor antes de comprar. O servidor MCP (TypeScript) está incluído no download pago.
Não. O Godot MCP Pro é uma compra única de $5 com atualizações vitalícias para v1.x, projetos ilimitados, máquinas ilimitadas e suporte via Discord. Sem taxas recorrentes, sem limite de licenças.
Comece a usar em menos de 5 minutos.
Copie a pasta addons/godot_mcp/ do download para o diretório raiz do seu projeto Godot. Em seguida, ative o plugin:
Project > Project Settings > Plugins > Godot MCP Pro > Enable
Abra um terminal no diretório server/:
cd server npm install npm run build
Adicione o servidor ao arquivo de configuração MCP do seu cliente de IA (ex.: .mcp.json para Claude Code):
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
Abra seu projeto Godot com o plugin ativado. O painel de status no dock do editor mostra o estado da conexão. Inicie seu assistente de IA e comece a criar — ele agora tem acesso direto a 163 ferramentas no seu editor Godot.
Pague uma vez, use para sempre. Atualizações vitalícias para v1.x incluídas.