Godot MCP 安裝教學：addons 安裝並連接 AI IDE

本教學能幫你完成什麼

跟著下面五步，你可以把開源 Godot MCP 接到本機 Godot 專案，並讓 Cursor（或其他支援 MCP 的 AI IDE）直接操作、預覽、除錯編輯器——而不只是改磁碟上的腳本檔案。

完成後你應能：

• 把插件放進專案的 addons 目錄並啟用
• 啟動本地 Godot MCP Server（預設連接埠 3000）
• 用面板裡的「一鍵設定」把服務寫進 Cursor，並確認連線成功

開源倉庫：DaxianLee/godot-mcp

前置條件

項目	說明
Godot	已安裝，並有一個可開啟的專案
插件包	從 GitHub 下載的 godot-mcp 發行包或原始碼壓縮包
AI IDE	推薦 Cursor；也可用其他支援 MCP 的用戶端
本機網路	MCP 橋接通常跑在 127.0.0.1，勿把連接埠暴露到公網

步驟 1：下載 Godot MCP

從 GitHub 下載開源 Godot MCP：

倉庫地址： https://github.com/DaxianLee/godot-mcp

建議：

1. 打開倉庫頁面，使用 Code → Download ZIP，或下載 Releases 中的最新包
2. 將壓縮包儲存到本機，準備解壓縮
3. 確認包內是 Godot 插件結構（通常含 addons 相關目錄或可直接放入 addons 的插件資料夾）

步驟 2：把 Godot MCP 引入專案

1. 在本機解壓縮下載的壓縮包
2. 將解壓縮得到的插件資料夾移動到 Godot 專案根目錄下的 addons 目錄
   • 若專案裡還沒有 addons，先新建該資料夾
3. 用 Godot 打開（或重新載入）該專案，確認插件檔案已出現在檔案系統中

引入後的專案目錄示意如下：

步驟 3：啟用 Godot MCP 插件

1. 打開 專案 → 專案設定（或你當前 Godot 版本對應的專案設定入口）
2. 進入 插件 相關頁籤
3. 找到 Godot MCP Server（名稱以面板實際顯示為準）
4. 勾選啟用

啟用成功後，編輯器側邊或停靠面板中會出現 Godot MCP 相關入口，供下一步設定連接埠與啟動服務。

步驟 4：啟動 Godot MCP Server

1. 在 Godot 編輯器 右側面板 找到已啟用的 GodotMCP 面板
2. 檢查並按需調整：
   • 連接埠：預設 3000
   • 語言：按你的介面習慣選擇
   • 啟動狀態：可勾選 自動啟動，之後打開專案時更省事
3. 點選 啟動 按鈕
4. 當面板出現 「執行中」 提示時，說明 Godot MCP Server 已啟動成功

此時本機已有可用的 MCP 橋接，接下來把它交給 AI IDE。

步驟 5：一鍵設定 AI IDE（以 Cursor 為例）

1. 在 GodotMCP 面板中點選 「工具」
   • 查看 Server 暴露的工具列表
   • 按需要勾選你希望 AI 使用的能力
2. 點選 「設定」
   • 選擇目標 IDE（例如 Cursor）
   • 點選 「一鍵設定」
   • 等待提示 設定成功
3. 打開 Cursor
   • 在 MCP / 工具列表中應能看到 godot-mcp 已自動連線
   • 若尚未出現，在 Cursor 中點選 「重新載入」（或等價的 MCP 重載操作）後再看一次

設定與連線示意：

連線成功後的快速驗證

在 Cursor 中可先做一次唯讀確認，例如：

列出當前 Godot 活動場景的根節點。

若回覆與編輯器 Hierarchy 一致，說明橋接正常。再嘗試小範圍寫入（如新建臨時節點並刪除），確認權限與工具勾選符合預期。

常見問題

addons 裡放好了，插件列表卻沒有 Godot MCP Server？
檢查資料夾是否直接位於 addons/<插件名>/ 下，而不是多嵌套了一層解壓縮目錄；然後重新載入專案或重啟 Godot。

點了啟動但沒有「執行中」？
確認連接埠 3000（或你改過的連接埠）未被佔用；關閉防火牆對 localhost 的誤攔後再試。

Cursor 裡看不到 godot-mcp？
回到 Godot 面板確認服務仍為「執行中」，再執行一鍵設定；最後在 Cursor 中重新載入 MCP。仍失敗時，核對 Cursor 的 MCP 設定檔是否寫入了本地橋接位址。

自動啟動勾了還是要手動點？
部分版本需先成功手動啟動一次；確認勾選已儲存後，下次打開同一專案再驗證。

下一步

• 用自然語言做一次場景查詢或小改動，熟悉工具邊界
• 大改前先提交版本；橋接僅保留在本機 localhost
• 若還在做設計稿到引擎 UI，可搭配 VberAI AI Studio 處理 Figma / PSD 交接，再用 MCP 做編輯器內迭代

更多 Godot + MCP 背景可讀：我們如何為 Godot 打造即時 MCP Server。