安裝
Enable the Beckett EditorPlugin (writes .mcp.json)適合誰
你在 Godot 4 編輯器裡做 GDScript 或 C# 遊戲,希望 Claude 或 Cursor 直接檢查、編寫、執行並看見場景,而不想再掛 Node 或 Python 橋、也不想第二行程或雲端。Beckett 是嵌在編輯器裡的 GDScript EditorPlugin,零 sidecar。
免費 MIT Lite 涵蓋完整的 inspect → author → run → SEE 循環,共 55 個工具。本頁沒有點名這 55 個工具,因此不要編造場景樹或腳本工具名。
官方倉庫單獨一行:
https://github.com/beckettlab/beckett-godot-mcp
3 分鐘完成第一次嘗試
只走官方的一步安裝:在 Godot 4 裡啟用此外掛。啟用後服務會自動啟動,並寫入 .mcp.json,讓 claude 或 Cursor 無需手改設定即可連接。不需要安裝 Node.js。
前置條件:本機已有 Godot 4 編輯器,並能打開帶該 addon 的專案。除 addon 外沒有別的要裝。執行時是編輯器主執行緒上輪詢的 TCPServer HTTP/JSON-RPC。
設定位置:Godot 外掛開關,以及專案裡自動產生的 .mcp.json。不要手寫一份與自動檔案衝突的伺服器設定。若不想自動啟動,官方給出 opt-out:beckett/autostart=false。
低風險第一步:先做 inspect,只觀察專案,不要 author 或 run。成功訊號是外掛啟用後服務起來、.mcp.json 出現,並且 Claude 或 Cursor 能連上。本頁無具體 inspect 工具名,不要編造。
安全邊界:只監聽 localhost,帶 Origin 校驗(防 DNS-rebind),可選 bearer token,以及 read-only / allowlist / confirm-destructive 門閂。不要把 localhost 理解成無網路或無本機讀取;它仍在本機打開 HTTP,並讀寫編輯器裡的專案。readOnlyHint 不是零風險。
準備改場景或跑遊戲前,先確認 destructive 需要確認。author 與 run 會改專案或啟動遊戲,官方未給撤銷命令。
使用案例
案例一:先檢查當前專案。啟用外掛,讓用戶端走 .mcp.json 連上,只使用 inspect。55 個工具裡哪些屬於 inspect 未點名。GDScript 與 C# 都在 Lite 範圍內。
案例二:再編寫或執行前,打開確認門閂。官方循環是 inspect → author → run → SEE。author 會改專案,run 會在編輯器裡跑遊戲。有 confirm-destructive 與 allowlist。沒有工具名就不要呼叫寫入。可選 bearer token 未寫如何產生。
使用邊界
零 sidecar 不等於沒有本機 HTTP。無雲、無第二行程,但仍綁定 localhost。自動寫 .mcp.json,可用 beckett/autostart=false 關閉自啟。55 個工具未點名。Lite 是 MIT 免費版。官方未寫埠號、Godot 小版本和解除安裝後如何刪 .mcp.json。