godot-mcp-pro MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

169 MCP tools across 23 categories for comprehensive Godot 4 development
Real-time WebSocket connection with auto-reconnect and heartbeat monitoring
Full UndoRedo integration — all node/property operations are reversible
Smart type parsing for Vector2, Color, hex codes, and Godot-specific types
Three modes: Full (169 tools), Lite (80), Minimal (35) for different client limits

Demo ao vivo

Como fica na prática

godot-mcp-pro-2.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "godot-mcp-pro-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "godot-mcp-pro-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/youichi-uda/godot-mcp-pro"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add godot-mcp-pro-2 -- TODO 'See README: https://github.com/youichi-uda/godot-mcp-pro'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: godot-mcp-pro

How to build a Godot scene with AI using Godot MCP Pro

👤 Godot developers who want AI-assisted scene creation ⏱ ~20 min beginner

Quando usar: You want to quickly prototype a game scene by describing it in natural language.

Pré-requisitos

Godot 4 with MCP Pro plugin — Copy addons/godot_mcp/ to your project, enable in Project Settings → Plugins
Node.js MCP server — cd server && npm install && npm run build

Fluxo

Describe the scene

Create a 2D platformer level with a player CharacterBody2D, 5 platforms as StaticBody2D, and a goal area. Set up collision shapes for all.✓ Copiado

→ Scene tree created with all nodes, collision shapes, and proper hierarchy
Add scripts

Attach a movement script to the player with gravity, jump, and horizontal movement. Use Input.is_action_pressed for inputs.✓ Copiado

→ GDScript attached and functional
Test the level

Start a playtest and tell me if the player can reach the goal. Check for collision issues.✓ Copiado

→ Playtest results with observations

Resultado: A playable prototype level built entirely through natural language.

Armadilhas

Too many tools overwhelm some MCP clients — Switch to Lite (80 tools) or Minimal (35) mode if your client struggles with the full set

Combine com: filesystem

Create and iterate on animations in Godot with AI assistance

👤 Game developers working on character animations and effects ⏱ ~15 min intermediate

Quando usar: You want to create, tweak, or debug animations without manually editing keyframes.

Pré-requisitos

Godot MCP Pro connected — Plugin enabled and MCP server running

Fluxo

Create an animation

Create an AnimationPlayer on the player node with a 'walk' animation: translate the sprite 4 pixels up and down over 0.4 seconds, looping.✓ Copiado

→ Animation created with keyframes set
Preview and adjust

Play the walk animation. It looks too fast — slow it down to 0.6 seconds and add an ease-in-out curve.✓ Copiado

→ Animation updated with new timing and easing

Resultado: Polished animation created and refined through iterative AI feedback.

Armadilhas

Complex AnimationTree setups are hard to describe in natural language — Build the AnimationTree structure step by step, one blend node at a time

Combinações

Combine com outros MCPs para 10× de alavancagem

godot-mcp-pro-2 + filesystem

Generate and save GDScript files alongside scene modifications

Create an enemy AI script with patrol and chase states, save it as res://scripts/enemy_ai.gd, and attach it to the enemy node.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
create_node	type: str, name: str, parent_path?: str	Add a new node to the scene tree
set_property	node_path: str, property: str, value: any	Set any property on a node (supports UndoRedo)
attach_script	node_path: str, code: str	Attach a GDScript to a node
create_animation	player_path: str, name: str, keyframes: obj	Create an animation with keyframes
run_scene	scene_path?: str	Start a playtest of the current or specified scene
get_scene_tree	none	Get the current scene tree structure

Custo e limites

O que custa rodar

Cota de API: N/A — fully local WebSocket connection
Tokens por chamada: 100–500 tokens per tool call
Monetário: $5 one-time purchase — includes lifetime updates
Dica: Use Minimal mode (35 tools) if you only need basic scene and script operations.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: N/A — local WebSocket connection only

Saída de dados: All communication is local between MCP server and Godot editor (localhost WebSocket)

Solução de problemas

Erros comuns e correções

WebSocket connection failed

Ensure the Godot plugin is enabled and the Node.js server is running. Check the port in .mcp.json matches the plugin settings.

Verificar: Check Godot's output panel for MCP plugin messages

Tool count exceeds client limit

Switch to Lite (80 tools) or Minimal (35 tools) mode in the MCP configuration.

Verificar: Update the mode parameter in .mcp.json

Property not updating

Some properties require the scene to be saved and reloaded. Try saving the scene after the change.

Verificar: Check the Godot Inspector panel for the property value

Alternativas

godot-mcp-pro vs. outros

Alternativa	Quando usar	Troca
Godot MCP (free community)	You want a free alternative with fewer features	Fewer tools but no cost

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills