Blender MCP 沒有官方版本？本文整理 12 個社群實作，從 live bridge 到 headless 架構，帶你依情境選對專案並完成 Claude Desktop 與 Cursor 的接線設定。
Blender 本身沒有官方的 Model Context Protocol（MCP）伺服器，也沒有官方定義的「LLM Agent 協定」；它提供的是 CLI 啟動參數與內建 Python API（bpy）。不過社群已經發展出多套 MCP wrapper，讓 Claude Desktop、Cursor 等 MCP client 可以透過自然語言指令操作本地 Blender。本文整理 12 個相關專案，說明 live bridge 與 headless 兩種架構的差異，並給出實際安裝步驟與挑選建議。
Blender 的 CLI 與 Python API：先釐清事實
Blender 原生提供的能力是：
- CLI 啟動參數：
blender --background（headless，不開 GUI）、blender --python script.py、blender --python-expr "..."、blender file.blend --background --python script.py等。 - 內建 Python API：
import bpy可以操作場景、物件、材質、動畫、渲染等。 - 沒有內建 MCP：所有 MCP / socket / HTTP 串接都是社群自製的 wrapper，使用前需要自行評估維護狀態與安全性。
兩種讓 Agent 操作 Blender 的架構
Headless 模式
MCP server 直接呼叫 blender --background --python 執行腳本，不開啟 GUI。適合批次產生資產、自動渲染、匯出檔案，也可以在沒有顯示器的 server / VPS 上運行。
Live bridge 模式
Blender 內安裝 addon，在內部開啟 socket 或 HTTP server；MCP server 透過 TCP / HTTP 把指令送進 Blender，場景會即時在 viewport 中更新。適合需要邊聊天邊看結果、即時除錯與微調的工作流程。
12 個社群 Blender MCP 專案比較
| 專案 | 主要特色 | 架構 / 協定 | 需要 addon | Headless 支援 | 備註 |
|---|---|---|---|---|---|
| ahujasid/blender-mcp | 最早一批、文件完整、有官方網站 | TCP socket + JSON；MCP server 用 Python | 需要 | 可，但設計偏 live bridge | 支援 Claude Desktop、Cursor，安裝步驟清楚 |
| sandraschi/blender-mcp | headless-first；41 個工具、150+ 操作 | FastMCP；stdio 或 HTTP | 可選 | 主打 headless | 適合本地部署與大量自動產出 |
| dcc-mcp/dcc-mcp-blender | DCC MCP 生態系；MCP server 直接嵌在 Blender | Streamable HTTP MCP；內建 dcc-mcp-cli gateway | 需要（Extensions 安裝） | 可，但偏 IDE / agent gateway | 適合把 Blender 當 local MCP node 長期跑 |
| djeada/blender-mcp-server | 27 個工具 / 7 個 namespaces；含 async jobs | stdio MCP → TCP 到 Blender | 需要（bridge zip） | 可搭配 --background | 文件清楚，有 build addon zip 腳本 |
| youichi-uda/blender-mcp-pro | 100+ 工具；涵蓋 lights、modifiers、animation、shader nodes、geometry nodes | HTTP MCP | 視實作 | 支援 | 工具粒度細，適合進階 node / animation 控制 |
| 3Dean/blender_mcp_server | automated rendering、scene creation、Python script execution | MCP server（Python） | 通常需要 | 支援 | 精簡，適合當基礎模板擴充 |
| CommonSenseMachines/blender-mcp | Text-to-4D Worlds；結合 CSM.ai + LLM + Blender | MCP + 自訂協議 | 有 addon.py | 可 | 偏研究 / demo 導向 |
| pranav-deshmukh/blender-mcp | 簡單 JSON-over-TCP，讓任何 LLM 控制 Blender | TCP socket + JSON | 通常需要自寫 bridge | 可 | 結構單純，容易修改 |
| PatrykIti/blender-ai-mcp | goal-first routing、curated tools、deterministic verification | MCP + 自訂 routing / verification | 多半需要 | 可 | 偏安全、可控的生產環境設計 |
| Gorav22/Blender-mcp | 連接 Claude + Cursor；prompt-assisted modeling | MCP | 多半需要 | 可 | 功能基礎，適合入門 |
| dhakalnirajan/blender-open-mcp | 有明確 server / client CLI；可接 Ollama | FastMCP；CLI entry points | 視實作 | 可 | 適合自包 CLI wrapper 給 agent |
| YellowFoxH4XOR/blender-mcp | headless-first、safe、deterministic；typed tools 檢視場景與預覽渲染 | MCP | 多半 headless bpy | headless-first | 適合不想任意執行 Python 的安全表面 |
以上皆為社群實作，沒有官方背書。使用前建議閱讀 README 與 issues，確認是否持續維護，並特別留意「允許任意 Python exec」的伺服器所帶來的安全風險。
依使用情境挑選專案
情境 A：要即時看到 viewport 變化
推薦 ahujasid/blender-mcp、dcc-mcp/dcc-mcp-blender、djeada/blender-mcp-server。安裝 addon 後啟動監聽，MCP server 透過 TCP / HTTP 送指令，Blender 即時執行 bpy 操作。適合與 Claude / Cursor 協作、即時回饋與微調。
情境 B：headless 大量產出、渲染、匯出
推薦 sandraschi/blender-mcp、YellowFoxH4XOR/blender-mcp、3Dean/blender_mcp_server。主要用 blender --background 加 Python 腳本，適合批次產生 3D 資產、場景變體、多視角多光照自動渲染，以及無顯示器的伺服器環境。
情境 C：自己包一層 CLI / API
參考 dhakalnirajan/blender-open-mcp（有明確 server / client CLI）、pranav-deshmukh/blender-mcp（簡單 JSON-over-TCP）、PatrykIti/blender-ai-mcp（goal-first routing + verification）。這些可以當 reference implementation，再依自己的技術棧改寫。
實際接線步驟（以 ahujasid/blender-mcp 為例）
假設你已安裝 Blender 4.x，並使用 Claude Desktop 或 Cursor 作為 MCP client。
1. 安裝 MCP server
先將專案 clone 到本地，再依 README 使用 uv 或 pip 安裝相依套件。
2. 在 Blender 安裝 addon
將 addon.py 或打包好的 zip 透過 Edit → Preferences → Add-ons → Install 安裝並啟用。在 3D Viewport 側邊欄（N）找到「MCP for Blender」，設定 port（例如 9876）並啟動監聽。
3. 設定 MCP client
在 claude_desktop_config.json 或 Cursor 的 MCP 設定中加上：
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
重啟 Claude Desktop / Cursor。
4. 用自然語言控制
例如：「Create a red cube on a gray floor with a sun lamp.」Agent 會透過 MCP 呼叫工具，Blender 即時建立物件。
Headless 變體
不安裝 bridge addon，改讓 MCP server 直接呼叫 blender --background file.blend --python script.py，在腳本內用 bpy 操作即可。
讓 Agent 更有效率地操作 Blender
固定 tool schema
不要讓 agent 任意寫 Python，而是定義一組高階工具，例如 create_cube、add_light、apply_material、render_view、export_glb。token 用量較少、錯誤率較低，也容易驗證。
區分設計模式與生產模式
- 設計模式：live bridge + viewport，讓人與 agent 共同迭代。
- 生產模式：headless + 參數化腳本，大量產出。
加入快取與版本控制
將場景、材質、渲染設定參數化，存放在 Git 或資料庫。Agent 只改參數，不重寫整個腳本，方便 diff 與回滾。
安全提醒
多數 Blender MCP 伺服器本質上允許 Agent 在本地執行 Python 程式碼，等同於取得本機執行權限。使用前應確認專案維護狀態、了解 addon 的網路監聽行為，並避免在未受信任的環境中執行來路不明的 MCP server。
結論
Blender 雖然沒有官方 MCP 協定，但社群已提供多種成熟的接線方案。需要即時視覺回饋時，選 live bridge 架構；需要批次渲染與大量產出時，選 headless 架構；想整合到自有 agent framework 時，則可參考 CLI wrapper 與 routing 設計。先確認自己的工作流程，再挑選維護狀態良好的專案，就能讓 LLM Agent 穩定地操作本地 Blender。