godot-mcp-pro MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

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

即時演示

實際使用效果

godot-mcp-pro-2.replay ▶ 就緒

0/0

安裝

選擇你的客戶端

~/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"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

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

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "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"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json

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

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json

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

加入 context_servers。Zed 儲存後熱重載。

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

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： 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

何時使用： You want to quickly prototype a game scene by describing it in natural language.

前置條件

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

步驟

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.✓ 已複製

→ 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.✓ 已複製

→ GDScript attached and functional
Test the level

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

→ Playtest results with observations

結果： A playable prototype level built entirely through natural language.

注意事項

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

搭配使用： filesystem

Create and iterate on animations in Godot with AI assistance

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

何時使用： You want to create, tweak, or debug animations without manually editing keyframes.

前置條件

Godot MCP Pro connected — Plugin enabled and MCP server running

步驟

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.✓ 已複製

→ 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.✓ 已複製

→ Animation updated with new timing and easing

結果： Polished animation created and refined through iterative AI feedback.

注意事項

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

組合

與其他 MCP 搭配，撬動十倍槓桿

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.✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
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

成本與限制

運行它的成本

API 配額: N/A — fully local WebSocket connection
每次呼叫 Token 數: 100–500 tokens per tool call
費用: $5 one-time purchase — includes lifetime updates
提示: Use Minimal mode (35 tools) if you only need basic scene and script operations.

安全

權限、密鑰、影響範圍

憑證儲存： N/A — local WebSocket connection only

資料出站： All communication is local between MCP server and Godot editor (localhost WebSocket)

故障排查

常見錯誤與修復

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.

驗證： 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.

驗證： 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.

驗證： Check the Godot Inspector panel for the property value

替代方案

godot-mcp-pro 對比其他方案

替代方案	何時用它替代	權衡
Godot MCP (free community)	You want a free alternative with fewer features	Fewer tools but no cost

godot-mcp-pro

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： godot-mcp-pro

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

前置條件

步驟

注意事項

Create and iterate on animations in Godot with AI assistance

前置條件

步驟

注意事項

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

godot-mcp-pro 對比其他方案

更多

資源