← 返回部落格

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

逐步安裝 VberAI Cocos Creator 2.x MCP Pro:解壓縮到專案 packages、重啟後啟用、啟動本地 MCP Server,並在 Cursor、Claude、Codex 等支援 MCP 的 AI IDE 中完成連線驗證。跟著下面五步,你可以把 Cocos Creator 2.x MCP(V…

發布於
  • cocos
  • cocos-creator
  • mcp
  • cursor
  • tutorial
  • cocos-mcp
  • ai

本教學能幫你完成什麼

跟著下面五步,你可以把 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 Creator2.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/zh-TW/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 版本。

重啟 Creator 後開啟擴充 MCP Server,用帳號密碼或信箱啟用碼完成啟用

步驟 4:啟動 cocos-mcp-server

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

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

在 MCP Server 設定中設定埠號並啟動服務,顯示執行中

步驟 5:一鍵設定 AI IDE(以 Cursor 為例)

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

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

工具管理與快速設定 Cursor,確認 cocos-creator 已連線

連線成功後的快速驗證

在 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 Studio 處理 Figma / PSD 交接,再用 MCP 做編輯器內迭代

Creator 3.x 專案請使用 Cocos Creator 3.x MCP 安裝教學,勿與 2.若要先弄清能力邊界、以及和「Cocos Creator AI」等說法的差別,見:Cocos Creator MCP 是什麼。x 壓縮包混用。更多引擎 MCP 背景也可參考站內 Cocos Creator MCP 影片設定教學。

你可能還會喜歡這些文章

2026 的 AI 遊戲開發:用 Unity / Godot MCP 留在編輯器閉環裡

梳理 AI 輔助 Unity、Godot 的工作流程:MCP 適合什麼、人要守住什麼,以及多引擎團隊如何共用同一套提示習慣。「AI 遊戲開發」這個說法,背後常混著三類工作:。含 MCP 安裝連線、AI Studio 實作步驟與驗收清單,VberAI 官方部落格教學。含 MCP 安裝連線、AI Studio 實作步驟與…

  • ai-game-development
  • unity-game-development
  • godot-game-engine
  • unity-mcp
閱讀全文

VberAI Studio 功能總覽:生圖、切圖、換皮、翻譯、摳圖

VberAI Studio / vberai studio:AI 生圖、原位切圖、一鍵換皮、UI 翻譯、像素化、摳圖、序列幀與匯出 Unity、Godot、Cocos——一次看清各功能與操作入口。VberAI Studio(≠ Google AI Studio)把遊戲介面和素材放在同一塊畫布上。本文按功能說明每一步做…

  • vberai
  • ai-studio
  • game-ui
  • image-gen
閱讀全文

VberAI 免費去背:光效 / 特效 / 半透明素材去背,輸出透明 PNG 與 Alpha

VberAI AI 超強去背三種模式:免費去背(純色背景、遊戲光效特效)、AI 去除背景(複雜背景,最高 4096×4096)、超強 AI 去背(髮絲、半透明、陰影,輸出透明圖 + Alpha 通道)。瀏覽器線上使用。VberAI AI 超強去背是瀏覽器內線上去背工具,面向遊戲素材設計,提供三種模式:免費去背(純色背…

  • vberai
  • ai-super-matting
  • matting
  • super-matting
閱讀全文