Cocos Creator MCP 是什麼？能做什麼，和「Cocos Creator AI」差在哪

在 Cocos Creator 專案裡用 AI 寫 TypeScript，往往只能看見磁碟上的腳本與設定；目前場景樹、未儲存的節點變更、元件屬性與預製體引用，多數仍要人在編輯器裡點。VberAI Cocos Creator MCP（下文簡稱 Cocos MCP）做的是另一件事：在 Creator 內跑本地 MCP 服務，讓 Cursor、Claude Code、Codex 等支援 MCP 的客戶端，按協定呼叫已開啟編輯器裡的操作面——而不只是改儲存庫檔案。

它不是新的遊戲引擎，也不替代 Creator 的渲染、建置與發佈。能力以目前外掛版本為準；下文依類別說明界線，不展開安裝逐步截圖。

它解決什麼問題

常見卡點是上下文斷層：

只有磁碟側 AI 時	接入 Cocos MCP 後
能改 .ts / 設定，但不知道目前場景開著什麼	可查詢開啟場景的節點層級與關鍵屬性
腳本寫完，還要手點掛元件、擺節點、對預製體	可在約定工具範圍內建立/調整節點、掛元件、做預製體相關操作
「編輯器裡剛才那次變更」對儲存庫快照不可見	以編輯器即時狀態為上下文（仍須人驗收）

適合已經在用 AI 寫腳本、又希望減少「腳本對了、場景對不上」往返的團隊。專案仍在 Cocos Creator 2.x 或 3.x——兩套外掛分開，勿混用壓縮包。

能做什麼（典型場景）

具體工具名稱與操作碼會隨版本迭代，更穩妥的理解是能力類別，而不是某一版的工具條數：

1. 場景與層級 — 開啟/儲存相關場景操作，查詢節點樹，做小範圍可逆變更
2. 節點與元件 — 建立或調整節點，增刪引擎元件與腳本掛載，改常見屬性
3. 預製體與資源 — 預製體瀏覽/實例化等輔助；資源查詢與基礎管理（以外掛暴露的工具為準）
4. 除錯輔助 — 讀取主控台或日誌、做場景完整性類檢查，便於定位「改完跑不起來」

建議習慣：先唯讀冒煙（例如列出目前場景根節點），再小步寫入，最後在 Creator 裡 Play / 預覽驗收。MCP 加速的是編輯器重複操作，不取消人工審改。

產品入口：

• Cocos MCP 3.x
• Cocos MCP 2.x

不能指望它做什麼

期望	實際界線
用 MCP「一鍵把 Figma 變成完整 UI 預製體」	設計稿結構化匯入屬於 VberAI Studio；MCP 在資源進專案後再做編輯器內迭代
自動完成行動裝置壓包、管道最佳化、發行設定	仍屬 Creator 建置與發佈管線，不是 MCP 自帶魔法
不開啟 Creator、只靠遠端服務改你的線上專案	橋接預設跑在本機 localhost；應對準目前開啟的專案
2.x 專案裝 3.x 包（或反過來）也能用	分外掛；混用是裝不上、連不上的常見原因
模型改完即可上線	與 Unity / Godot MCP 一樣：變更要在編輯器裡跑通並納入版本管理

開源版與 Pro 的差異、訂閱與啟用方式以官網目前說明為準；本文不展開商業條款。

「Cocos Creator AI」通常指什麼

搜尋裡的 Cocos Creator AI 往往是籠統說法，並不對應單一官方產品名稱。對照常見意圖：

說法 / 工具形態	主要上下文	典型產出
磁碟向程式碼助手（補全、改儲存庫）	腳本與設定檔	程式碼修補
文件 / 問答類「Cocos 助手」	文件與 API 說明	文字解答，不直接動你的場景
VberAI Studio	PSD / Figma 等設計結構	更接近引擎語意的 UI 層級與資源交接
Cocos MCP	已開啟的 Creator 編輯器	場景、節點、元件、預製體等編輯器側操作

若目標是「讓 Cursor 看見並改目前場景」，對應的是 MCP 編輯器橋接，而不是換一個只會答文件的聊天機器人，也不是用 MCP 硬扛切圖與佈局殼匯出。

VberAI 產品棧裡三者可組合、勿混稱：摳圖準備素材 → AI Studio 做介面結構交接 → Cocos MCP 在編輯器內接線與改節點。總覽見：VberAI 是什麼。

和「只改程式碼的 AI」差在哪

維度	以儲存庫為中心的 AI	Cocos MCP
主要上下文	磁碟上的腳本與資源	編輯器物件樹與目前專案狀態
常見動作	寫/改 TypeScript	查層級、改節點與元件、輔助預製體與除錯
驗收	編譯與單元測試仍有用	還需在 Creator 視埠與預覽裡確認

兩者可以並存：邏輯與架構仍可用原有編碼習慣；需要碰編輯器物件時再走 MCP。

若還在 Unity / Godot 與 Cocos 之間選型，見：Godot MCP vs Unity MCP vs Cocos MCP。

下一步

1. 確認專案是 3.x 還是 2.x，下載對應外掛包
2. 按安裝文件完成匯入、啟用、啟動服務，並在 AI IDE 裡看到 cocos-creator（或面板顯示的服務名稱）
3. 唯讀列出根節點 → 一次可逆小寫入 → 編輯器驗收

安裝與排障：

• Cocos Creator 3.x MCP 安裝
• Cocos Creator 2.x MCP 安裝
• Cocos MCP 連線失敗排查
• Cursor 連上後像壞了 / 連不上

影片向設定也可參考：Cocos Creator MCP 影片指南。

常見問題

什麼是 Cocos Creator MCP？
VberAI Cocos Creator MCP 將 MCP 客戶端（Cursor、Claude Code、Codex 及類似工具）橋接到開放的 Cocos Creator 編輯器，使其能夠查詢或操作場景、節點、組件和預製體（範圍取決於插件版本）。它不是新的引擎，也不會取代 Creator 的渲染或發佈功能。

它與「Cocos Creator AI」有何不同？
「Cocos Creator AI」通常是一個模糊的搜尋詞，並非單一官方產品。文檔問答機器人、純程式碼助手、AI Studio（設計轉引擎）和 MCP（編輯器橋接）解決不同的任務。如果目標是「讓 Cursor 查看並編輯當前開啟的場景」，那就是 MCP。

可以混合使用 2.x 和 3.x 的 MCP 套件嗎？
不可以。請下載與專案主版本相符的套件。安裝指南：3.x 和 2.x。

Cursor 連接後看起來壞了——接下來該怎麼辦？
依症狀進行分類排查：服務缺失、紅色錯誤、已連接但無工具。簡短指南：Cursor 與 Cocos MCP 故障處理；四層路徑：連接疑難排解。