Blender MCP 是什麼
MCP(Model Context Protocol)提供 agent 能操作其他程式的工具。兩個 Blender MCP 專案都由相同的兩個部分組成:一個在 Blender 內執行小型伺服器的外掛,以及一個由你的 agent 啟動的 MCP 伺服器,後者把工具呼叫以 JSON 格式透過 TCP socket 轉送給外掛。
多數人說的是 mcp-for-blender。它的 README 開頭就聲明這是第三方整合,並非 Blender 官方出品。它採用 MIT 授權,2026 年 11 月 21 日有 35,153 個 GitHub star,PyPI 套件已從 blender-mcp 改名為 mcp-for-blender(11 月 18 日發布 2.3.1 版);uvx blender-mcp 仍能啟動伺服器,所以舊的設定繼續可用。
Blender Lab 的 blender_mcp 是官方版本。它的 readme 稱其為輕量級伺服器,刻意做得很小,目標是用自然語言操作 Blender 的 Python API、更方便地查閱文件,以及探索複雜場景。它已列入 Claude 的連接器目錄,名稱為 Blender,作者 Blender Lab,經 Anthropic 驗證。
mcp-for-blender 與 Blender Lab 的 blender_mcp
數據來自 2026 年 11 月 21 日的 GitHub 和 projects.blender.org 儲存庫。
| mcp-for-blender(社群) | blender_mcp(Blender Lab) | |
|---|---|---|
| 作者 | Siddharth Ahuja;與 Blender Foundation 無關聯 | Blender Lab,Blender 專案的一部分 |
| 授權 | MIT | GPL-3.0 |
| Blender 版本 | 3.0 或更新 | 5.1 或更新 |
| Star 數 | GitHub 上 35,153 | projects.blender.org 上 39 |
| 工具 | 九個,包括 execute_blender_code、look(視埠和攝影機視圖)、get_scene_info、素材搜尋與匯入(Poly Haven、Sketchfab、Poly Pizza)以及 generate_3d(Tripo、Hunyuan3D、Hyper3D Rodin、Meshy) | execute_blender_code、execute_blender_code_for_cli(背景執行的 Blender)、blend 檔案和物件摘要、get_python_api_docs、螢幕截圖;內建 Python API 和手冊摘錄 |
| 安裝 | 一行指令的安裝程式或 uvx mcp-for-blender;內建對 Claude Code、Codex、Cursor 等的設定 | git clone 儲存庫並用 uv 執行;在 Blender 裡加入外掛 |
| 適合 | 建立和佈置場景、匯入素材、生成模型 | 檢查檔案、詢問 Blender API,搭配最新版本的 Blender |
快速安裝:一次設好所有 agent
mcp-for-blender README 推薦的方式是一行指令。它會在需要時安裝 uv,找出你機器上的 MCP 用戶端(Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、OpenCode、Antigravity),讓你選擇要設定哪些,然後安裝並啟用 Blender 外掛。它只會在每個設定裡加入一個 blender 項目,並為每個更動過的檔案保留 .bak 備份。完成後,請完全結束並重新開啟你的 agent。
下面的指令抄自 README;我們沒有執行過。把腳本透過管線交給 shell 會以你的權限執行它,所以如果你想看清每一步,請改用接下來兩節的手動設定。
- macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh - Windows(PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex - 已安裝 uv 時:
uvx mcp-for-blender setup - 你需要 Blender 3.0 或更新版本、Python 3.10 或更新版本,以及 uv。
在 Claude Code 安裝 Blender MCP
mcp-for-blender 的手動設定。指令抄自專案 README 和 Claude Code MCP 文件;我們沒有執行過。
安裝 uv
uv 提供啟動伺服器用的
uvx指令。README 提醒不要用pip install uv,請用官方安裝程式。# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -e註冊伺服器
這會把伺服器儲存到目前的專案。加上
--scope user就能在所有地方使用;這類選項要放在--之前,--用來把它們和伺服器指令隔開,這是 Claude Code 文件採用的寫法。在工作階段裡,/mcp會顯示同樣的狀態。# README 裡的指令 claude mcp add blender uvx mcp-for-blender # 檢查:應顯示伺服器已連線 claude mcp list claude mcp get blender選用:關閉遙測
README 說,在伺服器的環境變數裡設定
DISABLE_TELEMETRY=true即可完全關閉遙測。Claude Code 的claude mcp add用--env傳入環境變數;確切寫法請見 Claude Code MCP 文件。安裝並啟用 Blender 外掛
接著在 Blender 裡開啟 Edit → Preferences → Add-ons,啟用 "Interface: MCP for Blender"。在 3D 視埠裡按 N,開啟 MCP for Blender 分頁;伺服器會隨 Blender 啟動,如果沒有執行,請按 Start MCP Server。
# 把外掛以 blender_mcp.py 複製到 Blender 的外掛資料夾(保留 .bak 備份) uvx mcp-for-blender install-addon # 列出它找到的外掛資料夾 uvx mcp-for-blender addon-paths
在 Codex 安裝 Blender MCP
Codex CLI、桌面應用程式和 IDE 擴充功能共用 ~/.codex/config.toml,所以設定一次就涵蓋三者。指令抄自 README 和 OpenAI 的 Codex MCP 文件;我們沒有執行過。uv 和 Blender 外掛的安裝方式與 Claude Code 的步驟相同。
用 CLI 加入伺服器
Codex 下次啟動時就會顯示這些工具;在 Codex 終端機介面裡
/mcp會列出作用中的伺服器。在桌面應用程式裡,對應操作是 Settings → MCP servers → Add server,名稱blender,STDIO,指令uvx mcp-for-blender。# README 裡的指令 codex mcp add blender -- uvx mcp-for-blender # 檢查:blender 應顯示為已啟用 codex mcp list或者編輯 config.toml
[mcp_servers.blender]表來自 README。env這一行依據 Codex 文件,文件把env、startup_timeout_sec(預設 10)和tool_timeout_sec(預設 60)列為表的鍵;如果耗時較長的 Blender 操作逾時,就調高tool_timeout_sec。# 或者手動編輯 ~/.codex/config.toml(Codex CLI、桌面應用程式和 IDE 擴充功能共用) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]選用:Codex 外掛
README 為 Codex 推薦這個:它會在聊天裡顯示即時的 Blender 視埠、素材的縮圖選擇器,以及用 @ 提及場景物件。它還不在 Codex 外掛目錄裡,所以要從儲存庫加入。
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # 然後重新啟動 Codex,並從外掛目錄安裝 "MCP for Blender"
改裝 Blender Lab 的官方伺服器
Blender Lab 的設定 wiki 要求你在 Blender 5.1 或更新版本裡安裝它的外掛,把伺服器 clone 到你的家目錄,再用 uv 讓 MCP 用戶端指向它。下面是依 wiki 記錄的 clone 指令和設定;我們沒有執行過。如果你用 Claude,這個伺服器也列在 Claude 的連接器目錄裡,目錄註明需要安裝外掛。
git clone https://projects.blender.org/lab/blender_mcp.git,然後 {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
不要把兩個專案註冊在同一個 blender 名稱下。mcp-for-blender 的 README 還說,同一時間只執行它的一個伺服器實例,例如在 Cursor 或 Claude Desktop 裡用,但不要兩個同時用。
範例:agent 做出低多邊形道具並匯出 GLB
在 Blender 已開啟、外掛正在執行時,agent 透過 execute_blender_code 建模,並用 look 檢查成果。這是我們依據文件寫的,沒有完整跑過一遍,所以實際結果會有差異。關於用 glTF-Transform 壓縮 GLB 並在 three.js 裡載入,請看 vibegamer.io 上完整的 Blender MCP 指南。
儲存你的 .blend 檔案
agent 會直接編輯你開啟的檔案。README 的警告是:使用
execute_blender_code之前,務必先儲存你的作品。給 agent 下提示詞
給出尺寸、三角面預算和匯出路徑。純色基礎色可以順利匯出,因為 Blender 的 glTF 匯出器從 Principled BSDF 節點讀取基礎色。README 還提到,複雜的操作可能需要拆成更小的步驟。
Use the Blender MCP tools. 為一款網頁遊戲做一個低多邊形木箱: - 1 公尺立方體,放在地面 z = 0 上,原點在底面中心。 - 帶倒角的木板和角撐,三角面少於 800。 - 只用 Principled BSDF 基礎色(木色、深色金屬),不用圖片貼圖。 - 套用所有修改器,把所有部件合併成一個名為 "Crate" 的物件。 - 用 look 工具從幾個角度檢查,修正懸空的部分。 - 只選取 "Crate",匯出為 GLB 到 ./public/models/crate.glb。 每個腳本執行前先給我看。在匯出腳本執行前先讀一遍
匯出通常以類似下面的呼叫收尾,用的是 Blender
export_sceneAPI 的參數。GLB 把網格、材質和貼圖打包進一個檔案。檢查路徑是否在你的專案內。import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # 一個二進位檔案,包含網格、材質和圖片 use_selection=True, # 只匯出選取的 "Crate" export_apply=True, # 匯出時套用修改器 export_yup=True, # +Y 朝上 )
Blender MCP 安全嗎?該鎖定什麼
把它當作給了 agent 一個 Blender 裡的 Python shell。以下幾點來自 mcp-for-blender 的 README。
- 任意 Python:
execute_blender_code會執行 agent 寫的任何 Python。README 稱這有潛在危險,並要求務必先儲存你的作品。核准之前先讀腳本。 - 安全模式:設定
BLENDER_MCP_SAFE_MODE=1,在腳本執行前先做驗證。它會阻止直接讀寫檔案、執行其他程式、存取網路和持久化程式碼;建模、材質、算圖、儲存和匯入/匯出仍然可用。 - socket 沒有驗證:外掛的伺服器(預設連接埠 9876)沒有驗證也沒有加密,所以任何能連到該連接埠的人都能在 Blender 裡執行 Python。除非你在可信任的網路裡,否則讓
BLENDER_HOST保持為localhost。 - 遙測:預設會傳送匿名的安裝 ID、工作階段 ID、工具名稱、是否成功、耗時、版本、作業系統和時間戳記。提示詞、產生的程式碼、螢幕截圖和場景資料只有在你選擇加入時才會傳送,而選擇加入的資料可能被用來訓練 AI 模型。設定
DISABLE_TELEMETRY=true可完全關閉。 - 第三方金鑰:3D 生成和部分素材來源使用以環境變數傳入的 API key(例如
BLENDERMCP_MESHY_API_KEY)。Poly Pizza 的模型約 69% 是 CC-BY,所以需要標註出處,除非你只篩選 CC0。
用 Blender MCP,還是 Blender skill?
MCP 伺服器給 agent 一條通往正在執行的 Blender 的即時連線。skill 給它某個工作流程的書面說明和腳本,例如 EL4CTEO/blender-skills(28 個適用於 Blender 5.2 LTS 以上的工作流程 skill,適用於 Claude Code、Codex 等)。兩者搭配得很好:skill 告訴 agent 怎麼做出可直接用於遊戲的素材,MCP 伺服器讓它在你開啟的場景裡完成。
我們在遊戲開發 skills裡列出了 Blender 和遊戲製作的 skill 與 MCP 伺服器,vibegamer.io 在遊戲開發 agent skills裡對它們做了比較。
Crewmark:和寫程式的員工在同一個看板上的 3D 美術
Blender MCP 圍繞一次一個工作階段設計:你下提示詞,agent 建模,你來審查。如果你想要一個連續好幾天持續製作素材的 agent,同時其他 agent 在寫遊戲程式碼,Crewmark 是另一個選擇。
在 Crewmark 裡,每個 agent 都是一位 AI 員工:一個有角色、長時間運作的工作階段,執行在你自己的機器上。Claude Code 和 Codex 員工以原生方式執行;其他 agent,例如 OpenCode、DeepSeek Harness 和 Gemini,則透過 ACP(acpx)連接。工作透過共用的議題看板流動,你和員工在上面指派議題、留言、互相 @提及並更改狀態。寫程式的員工就是這樣向 Blender 員工要一個新道具:在議題上 @提及它。員工會依排程(heartbeat)醒來,被提及時也會醒來,所以工作不用你轉交就會開始。
它不取代 Blender MCP;裝了這個伺服器的員工仍然會用它。它加上的是圍繞它的角色、看板和喚醒機制。
常見問題
Blender MCP 免費嗎?
免費。mcp-for-blender 是 MIT 授權的開源專案,它的網站說除了 3D 生成之外,所有功能在免費方案都能用;3D 生成需要 Premium 方案(每月 10 美元起)或你自己的服務供應商 API key。Blender Lab 的伺服器採用 GPL-3.0,免費。
Blender MCP 安全嗎?
它會在 Blender 裡執行 agent 寫的任何 Python,而且它的 socket 伺服器沒有驗證。先儲存你的作品,核准之前先讀腳本,只在 localhost 上使用,並設定 BLENDER_MCP_SAFE_MODE=1 來阻止檔案存取、其他程式和網路存取。設定 DISABLE_TELEMETRY=true 可關閉使用遙測。
有官方的 Blender MCP 伺服器嗎?
有。Blender Lab 在 projects.blender.org 發布了 blender_mcp(GPL-3.0,Blender 5.1+),並列在 Claude 的連接器目錄裡,作者標為 Blender Lab。熱門的 mcp-for-blender 是第三方專案,與 Blender Foundation 無關聯。
怎麼把 Blender MCP 加到 Claude Code?
安裝 uv,執行 claude mcp add blender uvx mcp-for-blender,用 claude mcp list 檢查,然後用 uvx mcp-for-blender install-addon 安裝並啟用 Blender 外掛。或者執行 README 裡的一行指令安裝程式,它會幫你設定好 Claude Code。
怎麼把 Blender MCP 加到 Codex?
執行 codex mcp add blender -- uvx mcp-for-blender,或者在 ~/.codex/config.toml 裡加入 [mcp_servers.blender] 表,寫上 command = "uvx" 和 args = ["mcp-for-blender"]。CLI、桌面應用程式和 IDE 擴充功能共用這個檔案。README 還提供了一個 Codex 外掛,能在聊天裡顯示即時視埠。
我該用 Blender MCP 還是 Blender skill?
agent 需要操作正在執行的 Blender 場景時用 MCP;想給它一個經過驗證的工作流程去遵循時用 skill。很多設定兩者都用:skill 描述工作流程,MCP 伺服器負責執行。
指令和功能已於 2026 年 11 月 21 日對照 mcp-for-blender 的 README、Blender Lab 的 blender_mcp 儲存庫和 wiki、Claude Code 與 Codex 的 MCP 文件,以及 Blender 的 glTF 匯出文件查證。我們沒有執行安裝指令。