
Claude Code 本來只活在文字與程式碼的世界裡,但透過 MCP(Model Context Protocol),可以讓它變成一個真的能「伸手」進 3D 軟體場景裡的助理 —— 讀取場景物件、修改 Transform、執行腳本、甚至觸發渲染。
這篇教學記錄我把 Claude 接上 Maya 的完整過程。好消息是 Maya 這邊有現成的開源套件支援,裝一裝就能用。跟我另一篇寫 3ds Max 那次比起來,這篇你大概不會看到我抓狂的片段 —— 整個流程順到有點無聊(當然是好的那種無聊),十分鐘內可以搞定。
Table of Contents
ToggleMCP 是什麼(30 秒版)
說白話一點,它就是讓 AI 跟其他軟體「講同一種語言」的規則,設計的人是 Anthropic。有了這套共同規則,不同的 3D 軟體、不同的 AI 助理才不用各自摸索,直接照著規則接就好,不用每個人重新發明一次輪子。
安裝步驟
這邊我直接用現成的開源套件 dcc-mcp-maya,橋接的部分別人已經寫好了,我只要照著裝。五個步驟,喝杯咖啡的時間就能搞定。
# 打開 CMD 或 PowerShell
"C:\Program Files\Autodesk\Maya2025\bin\mayapy.exe" -m pip install dcc-mcp-maya
# 驗證安裝成功,應該輸出版本號(例如 0.9.0)
"C:\Program Files\Autodesk\Maya2025\bin\mayapy.exe" -c "import dcc_mcp_maya; print(dcc_mcp_maya.__version__)"看到版本號跳出來就代表環境沒問題,可以放心往下走。
# pip 套件本身不含 Maya plugin,要另外抓,沒什麼難度
New-Item -ItemType Directory -Path "$env:USERPROFILE\Documents\maya\2025\plug-ins" -Force
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/dcc-mcp/dcc-mcp-maya/main/maya/plugin/dcc_mcp_maya_plugin.py" -OutFile "$env:USERPROFILE\Documents\maya\2025\plug-ins\dcc_mcp_maya_plugin.py"# 路徑:C:\Users\<你的用戶名>\Documents\maya\2025\scripts\userSetup.py
# 注意:必須以 UTF-8 無 BOM 編碼儲存,否則 plugin 不會自動載入
import os
os.environ["DCC_MCP_MAYA_PORT"] = "9765"
os.environ["DCC_MCP_MAYA_SIDECAR"] = "0"
import maya.cmds as cmds
import maya.utils
maya.utils.executeDeferred(
lambda: cmds.loadPlugin("dcc_mcp_maya_plugin", quiet=True),
lowestPriority=True,
)這份檔案存好之後,剩下的手動操作就只有一步:打開 Maya,開啟 Script Editor(Window > General Editors > Script Editor),在 Python 分頁貼上並執行跟 Step 3 一樣的環境變數設定,再接著跑:
cmds.loadPlugin(r"C:\Users\<你的用戶名>\Documents\maya\2025\plug-ins\dcc_mcp_maya_plugin.py")
# 看到 "MCP server v0.9.0 started at http://127.0.0.1:9765/mcp" 就代表成功,那一刻其實還蠻有成就感的
cmds.pluginInfo("dcc_mcp_maya_plugin", edit=True, autoload=True)
# 確認輸出 Autoload: True{
"mcpServers": {
"maya": { "type": "http", "url": "http://127.0.0.1:9765/mcp" }
}
}設定檔存好,重新連接一次 MCP,你的 Claude 就正式跟 Maya 接上線了。
日常使用流程
設定完一次之後,之後每次要用都超簡單:
- 打開 Maya —— plugin 會自動載入,server 自動在固定 port 監聽,不用再做任何事
- 開始讓 Claude 操作場景
疑難排解
以下是我自己摸索時真的踩過、或聽人提起最多次的幾個狀況,你如果卡住,大概率是這幾個原因之一:
為什麼 Plugin 沒有自動載入(顯示 False)?
⌄可能原因:userSetup.py 存成了帶 BOM 的 UTF-8(改用無 BOM 重新儲存)、Maya 有其他 userSetup.py 衝突(確認只有一個)、或沒有在 Plug-in Manager 中勾選 Auto load。
為什麼會連線失敗?
⌄先確認 Maya 中 server 有啟動,再到 Script Editor 找 started at http://127.0.0.1:XXXX/mcp 這行,跟 MCP 設定檔裡的 url 對一下。如果 port 是隨機產生的,代表 userSetup.py 的環境變數沒生效,可以在 Script Editor 手動設定 os.environ["DCC_MCP_MAYA_PORT"]。
為什麼會看到「sidecar spawn failed」訊息?
⌄別緊張,這是正常的,不影響使用。我們已經用 DCC_MCP_MAYA_SIDECAR=0 主動關閉 sidecar,如果 userSetup.py 沒先執行到才會看到這個警告,但 server 仍然會正常運行。
為什麼 pip install 會失敗?
⌄先執行 mayapy.exe -m pip install --upgrade pip,再重新執行安裝指令一次。
另外幾點值得記住:每次重啟 Maya 後,AI 助理可能需要重新連接 MCP servers;port 是手動固定的,如果被佔用可以改成其他數字(記得同步更新 MCP 設定檔);Plugin 的 Auto load 設定存在 Maya 的 preferences 裡,不需要每次重新設定。
參考連結
懶得自己動手?讓你的 Claude 直接幫你裝
上面的步驟其實不用自己一步步照著打指令 —— 我把完整安裝流程整理成一份專門給 AI 讀的指令檔,下載後把檔案內容貼給你的 Claude,跟它說「請照這份指令幫我安裝 Maya 的 MCP 連接」,它會自己執行指令、建立檔案、確認每一步是否成功,需要你確認的地方(例如 Maya 版本、使用者資料夾路徑)會直接問你。
📄 給 AI 助理讀的可執行安裝指令
如果你在設定過程中卡關,歡迎留言交流。如果你平常主力用的是 3ds Max,可以參考另一篇《為什麼要讓 Claude 連接 3ds Max》,那篇分享了在沒有現成方案的情況下,自己動手刻一座橋接的完整過程。這個系列還有第三篇《讓 Claude 直接操作 WordPress》,講的是 MCP 工具碰到邊界時怎麼換一條路走,有興趣可以一起看。
自動引用通知: 為什麼要讓 Claude 連接 3ds Max?一次分享我的動機、成果與經驗 - 樹讀
自動引用通知: Claude 連接 WordPress:MCP vs Claude for Chrome 該選哪個?