Godot MCP vs 手寫腳本：什麼時候該讓 AI 操控編輯器

在 Godot 4 裡做功能，多數時間花在改場景樹與寫／改 GDScript。手寫精確但重複多；Godot MCP 讓 Cursor、Claude Code 等客戶端用自然語言操作編輯器。關鍵不是「要不要用 AI」，而是哪類改動交給 MCP 更划算。

兩種方式差在哪裡

	手寫腳本	Godot MCP
工作方式	你在腳本與場景裡實現細節	你描述意圖，模型經 MCP 改節點、場景、腳本
強項	邊界條件、效能、可審查設計	批量樣板、快速試玩、跨檔接線
風險	慢、易陷入重複 CRUD	結構鬆散時，產出難維護

Godot MCP（產品頁）面向 Godot 4.x，原生 C++ GDExtension，MIT 開源；工具數量與類別以產品頁為準（撰寫時約 62 工具 / 23 類別）。相容 Claude Desktop、Claude Code、Cursor、Windsurf、Cline 等。它操控的是編輯器上下文，不是單純程式碼補全。

安裝：Godot MCP 安裝教學。

先守住 Godot 開發規範

• 場景自包含：對外用信號、匯出屬性或公開方法，避免深層硬編碼路徑（Scene organization）
• 組合優於堆繼承：移動、生命、視覺拆成可複用節點／場景
• 信號用於「回應」：過去式命名；少冒泡；Autoload 僅留給真正全域（Autoloads vs nodes）
• 場景表結構，腳本表行為

向 MCP 下指令時寫明約束（例如「用信號連血量與 HUD，不要新建 Autoload」）。

什麼時候用 Godot MCP

1. 原型試玩——手感、巡邏、臨時 HUD
2. 樣板系統——血條綁定、簡單背包、存讀檔骨架、選單腳手架
3. 批量接線——掛腳本、連信號、統一重新命名
4. 對照學習——生成一版後讀 diff

在 res://player/player.tscn 為 CharacterBody2D 加衝刺（冷卻 1s）；用信號通知 HUD，不要新建 Autoload。

什麼時候堅持手寫

1. 效能熱路徑——大量尋路、每幀配置
2. 強定制機制——提示很難說清的規則
3. 長期核心模組——戰鬥結算、存檔相容、連線同步
4. 排障——先讀現有程式與場景，再決定是否讓 MCP 改

Code Review 解釋不清的生成程式，不要合進主幹。

推薦工作方式

1. 先定場景邊界與信號契約
2. MCP 搭腳手架並跑通最小可玩版
3. 手寫／精修核心與熱路徑
4. 再用 MCP 做週邊迭代

UI／美術可走 AI Studio；引擎內腳本與場景樹歸 Godot MCP 或手寫。

下一步

1. Godot MCP 安裝教學
2. 在規範場景上做「只讀檢查 → 小改」
3. 只保留符合場景組織與信號約定的 diff

延伸：用 Godot MCP 做 2D 平台跳躍、AI Studio + 引擎 MCP 端到端實錄。