Cocos Creator 2.x MCP 安裝教學：packages 安裝並連接 AI IDE

本教學能幫你完成什麼

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

完成後你應能：

• 將外掛解壓縮並放入專案的 packages 目錄
• 重啟 Creator 後用 VberAI 帳號或信箱啟用碼完成啟用
• 啟動本地 Cocos MCP Server
• 用「快速設定 → 自動設定」把服務寫進 Cursor，並確認連線成功

產品頁：VberAI Cocos MCP 2.x

本文以 Cursor 為例；Claude Code、Windsurf、Cline 等 MCP 用戶端的勾選與連線步驟類似。

前置條件

項目	說明
Cocos Creator	2.4.x+ 等 2.x 專案（勿與 3.x 壓縮包混用）
外掛包	官網下載的 Cocos Creator 2.x MCP Pro 壓縮包
啟用方式	VberAI 帳號 + 密碼，或信箱 + 啟用碼
AI IDE	推薦 Cursor；也可用其他支援 MCP 的用戶端
本機網路	MCP 橋接通常跑在 127.0.0.1，勿把埠號暴露到公網

步驟 1：下載 Cocos Creator 2.x MCP

在 VberAI 官網下載 Pro 版本：

下載頁： https://www.vberai.com/game-engines/cocos2x?ch=CQZLC2FG

建議：

1. 開啟上述頁面，按帳號權限下載 Cocos MCP 2.x Pro 壓縮包
2. 將壓縮包儲存到本機，準備解壓縮
3. 確認目標專案是 Creator 2.x，避免與 3.x MCP 壓縮包混用

開源版與 Pro 的差異、訂閱說明以官網當前說明為準。

步驟 2：匯入外掛（放入 packages）

與 3.x「擴充管理 → 匯入擴充」不同，2.x 採用把外掛放到專案目錄的方式：

1. 將第一步下載的壓縮包在本機解壓縮
2. 把解壓縮得到的外掛資料夾移動到 Cocos Creator 專案根目錄下的 packages 目錄
   • 若專案裡還沒有 packages，先新建該資料夾
3. 確認外掛目錄結構位於 packages/<外掛名>/ 下，而不是多嵌套一層解壓縮目錄

放入完成後 先不要急著設定：需要重啟 Creator，擴充才會被正確載入（見下一步）。

步驟 3：啟用 cocos-mcp-server

1. 重新啟動 Cocos Creator，並開啟已放入外掛的專案
2. 選單列點選 擴充 → MCP Server
3. 在啟用介面任選一種方式：
   • 輸入 VberAI 帳號 + 密碼 登入啟用
   • 或輸入 信箱 + 啟用碼 完成啟用
4. 啟用成功後再進入 MCP Server 設定頁（下一步）

未啟用時通常無法正常啟動服務；請確認帳號方案或啟用碼對應當前 Pro 版本。

步驟 4：啟動 cocos-mcp-server

1. 啟用成功後，進入 MCP Server 設定 頁面
2. 依需求調整：
   • 埠號：按面板預設值或你的本機約定設定
   • 語言：按介面習慣選擇
   • 啟動狀態：可按面板選項設定（例如是否隨編輯器自動啟動，以實際 UI 為準）
3. 點選 「啟動服務」
4. 當面板出現 「執行中」 提示時，說明 Cocos MCP Server 已啟動成功

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

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

1. 點選 「工具管理」
   • 查看 Cocos MCP Server 暴露的工具列表
   • 按需要勾選你希望 AI 使用的能力
2. 點選 「快速設定」
   • 選擇目標 IDE（例如 Cursor）
   • 點選 「自動設定」
   • 確認介面顯示為 已設定 狀態
3. 開啟 Cursor
   • 在 MCP / 工具列表中應能看到 cocos-creator（或面板實際顯示的服務名稱）已自動連線
   • 若尚未出現，在 Cursor 中點選 「重新載入」（或等價的 MCP 重載操作）後再看一次

其他 AI IDE 的選擇與自動設定流程類似，只需在「快速設定」裡換成對應用戶端。

連線成功後的快速驗證

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

列出當前 Cocos Creator 開啟場景的根節點。

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

常見問題

packages 裡放好了，選單卻沒有「擴充 → MCP Server」？
確認已 完全重啟 Creator（不是僅重新整理場景）；檢查資料夾是否直接位於 packages/<外掛名>/，而不是多嵌套一層。確認下載的是 2.x 包而非 3.x。

啟用一直失敗？
核對帳號是否已開通對應 Pro 權益，或啟用碼是否過期、是否綁定了正確信箱。可在官網帳號中心核對後再回到面板重試。

點了「啟動服務」但沒有「執行中」？
確認埠號未被佔用；關閉防火牆對 localhost 的誤攔後再試。確認步驟 3 已啟用成功。

Cursor 裡看不到 cocos-creator？
回到 Creator 面板確認服務仍為「執行中」，再執行「快速設定 → 自動設定」；最後在 Cursor 中重新載入 MCP。仍失敗時，核對 Cursor 的 MCP 設定是否寫入了本地橋接位址。

下一步

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

Creator 3.x 專案請使用 Cocos Creator 3.x MCP 安裝教學，勿與 2.x 壓縮包混用。更多引擎 MCP 背景也可參考站內 Cocos Creator MCP 影片設定教學。