「Blender MCP」通常指 MCP for Blender,這是 Siddharth Ahuja 做的開源專案,能讓 AI agent 操控一個正在執行的 Blender。2026 年 11 月之前它叫 blender-mcp,多數教學仍用這個名字。連上之後,Claude Code、Codex、Cursor 或 Claude Desktop 可以透過聊天提示詞建立和編輯物件、設定材質、查看視埠、匯出檔案。
這篇指南講它是什麼、怎麼在 Claude Code 和 Codex 裡安裝,以及一個完整範例:agent 在 Blender 裡做一個低多邊形遊戲道具,匯出 GLB,用 glTF-Transform 壓縮,再由 three.js 在網頁遊戲裡載入。每條指令我們都在 2026 年 11 月 21 日對照了專案 README 和官方文件。安裝和範例我們自己沒有執行過,所以下面描述的結果是文件說應該發生的結果。
Blender MCP 是什麼
MCP(Model Context Protocol)是一種標準方式,讓 AI agent 擁有能操作其他程式的工具。MCP for Blender 有兩個部分:
- 一個 Blender 外掛:在 Blender 內部開一個 socket 伺服器(預設連接埠 9876),執行收到的指令。
- 一個 MCP 伺服器(Python 套件
mcp-for-blender):由你的 agent 在背景啟動,把 agent 的工具呼叫轉給外掛。
agent 主要靠寫 Blender Python 並在你開啟的 Blender 檔案裡執行來做事。README 列出了九個工具。最常用的是 execute_blender_code(在 Blender 裡執行 Python)、look(擷取視埠、相機或多角度畫面,讓 agent 檢查自己的成果)、get_scene_info(場景摘要),以及 search_assets / import_asset(從 Poly Haven、Sketchfab 和 Poly Pizza 取得模型、貼圖和 HDRI)。還有 generate_3d,用 Meshy、Tripo、Hunyuan3D 或 Hyper3D Rodin 產生模型。
它不是 Blender 官方做的。 README 開頭寫著「This is a third-party integration and not made by Blender」,GitHub 簡介也寫著「Not affiliated with the official Blender Foundation.」。它採用 MIT 授權,2026 年 11 月 21 日有 35,153 個 GitHub star。
不過 Blender 確實有自己的 MCP 伺服器。 Blender 專案下的 Blender Lab 在 projects.blender.org/lab/blender_mcp 發布了一個更小的版本,文件在 blender.org/lab/mcp-server。它的 readme 稱自己「deliberately small」。重點是 Blender Python API 文件、場景和檔案摘要、截圖以及執行程式碼。它需要 Blender 5.1 或更新版本,採用 GPL-3.0,當時是 v1.0.3(2026 年 9 月)。它也以「Blender」的名稱出現在 Claude 的連接器目錄裡,作者是 Blender Lab。我們在替代方案裡介紹它。
你需要準備什麼
- Blender 3.0 或更新版本(MCP for Blender 用,外掛宣告的最低版本是 3.0)。
- Python 3.10 或更新版本和 uv,也就是用
uvx執行伺服器的工具。下面的一行指令安裝程式會幫你裝好 uv。 - 一個支援 MCP 的 agent:依 README,可以是 Claude Code、Codex、Cursor、Claude Desktop、VS Code、OpenCode、Windsurf 或 Antigravity。
- 做遊戲的部分:Node.js(用於 glTF-Transform)和一個 three.js 專案。
快速安裝(一次設好所有用戶端)
README 推薦的方式是一條指令:它會安裝 uv,找出你電腦上的 agent,讓你選要設定哪些,並安裝、啟用 Blender 外掛。它只會在每個設定檔裡加一個 blender 項目,並為每個改動過的檔案保存一份 .bak 備份。
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
把網路上的腳本直接用管線交給 shell,會以你目前使用者的權限執行它。不想這樣的話,就用下面的手動步驟,做的是同樣的事,只是一步一步來。無論哪種方式,裝完都要完全結束並重新開啟你的 agent。
在 Claude Code 裡安裝 Blender MCP
- 安裝 uv。README 給的是:macOS 用
brew install uv,Linux 用curl -LsSf https://astral.sh/uv/install.sh | sh,Windows 用winget install --id=astral-sh.uv -e。它提醒不要用pip install uv,那樣可能不會產生uvx指令。 - 在 Claude Code 裡註冊伺服器。這是 README 裡的指令:
claude mcp add blender uvx mcp-for-blender
- 檢查。Claude Code 的 MCP 文件列出了
claude mcp list(顯示類似「✔ Connected」的狀態)和claude mcp get blender,工作階段裡的/mcp面板顯示的也是同樣的資訊。
預設情況下,claude mcp add 只把伺服器儲存給目前的專案。加上 --scope user 就能在所有專案裡用。文件裡的通用寫法是把伺服器指令放在 -- 之後:claude mcp add [options] <name> -- <command> [args...]。如果你加了 --scope 或 --env 這類選項,就必須寫 --。
要關閉專案的匿名使用統計,README 說要替伺服器設定環境變數 DISABLE_TELEMETRY=true。在 Claude Code 裡,用 --env 把它寫在 -- 之前傳入。
在 Codex 裡安裝 Blender MCP
Codex CLI、Codex 桌面應用程式和 IDE 擴充功能共用一個設定檔 ~/.codex/config.toml,所以設定一次就能涵蓋三者。
一般 MCP 伺服器。 README 裡的指令:
codex mcp add blender -- uvx mcp-for-blender
也可以手動加到 ~/.codex/config.toml:
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
執行 codex mcp list,確認 blender 顯示為已啟用。工具會在你下次啟動 Codex 時出現,在 Codex 終端機介面裡用 /mcp 可以列出執行中的伺服器。OpenAI 的 Codex MCP 文件還介紹了用於環境變數的 env 表、startup_timeout_sec(預設 10)和 tool_timeout_sec(預設 60)。在桌面應用程式裡,進入 Settings → MCP servers → Add server,命名為 blender,選 STDIO,輸入 uvx mcp-for-blender。
Codex 外掛。 README 推薦 Codex 走這條路線。它會在聊天裡加一個即時的 Blender 視埠、Poly Haven、Sketchfab 和 Poly Pizza 的縮圖選擇器,以及用 @ 提及場景物件。它還沒有進入 Codex 外掛目錄,所以要從儲存庫加入:
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex
然後重新啟動 Codex,在外掛目錄裡安裝 MCP for Blender,再請 Codex 使用它。
Cursor 和其他用戶端
在 Cursor 裡,開啟 Settings → MCP 新增一個全域伺服器,或是在專案裡建立 .cursor/mcp.json,內容如下:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
在 Windows 上,README 用的是 "command": "cmd" 加 "args": ["/c", "uvx", "mcp-for-blender"]。README 還提供了 Cursor 和 VS Code 的一鍵安裝按鈕,以及 Claude Desktop、OpenCode 和 Antigravity 的設定區塊。它說同一時間只能執行一份伺服器,例如用 Cursor 或 Claude Desktop,但不要兩個都開。
連接 Blender 外掛
快速安裝程式會替你完成這一步。手動操作如下:
- 執行
uvx mcp-for-blender install-addon。它會把外掛以blender_mcp.py複製到 Blender 的外掛資料夾。 - 在 Blender 裡開啟 Edit → Preferences → Add-ons,啟用 Interface: MCP for Blender。如果沒出現,重新啟動 Blender,或是點選 Install… 選擇複製過去的檔案。你也可以從儲存庫下載
addon.py來安裝。 - 在 3D 視埠裡按 N 開啟側邊欄,找到 MCP for Blender 分頁。Blender 開啟時外掛會自動啟動它的伺服器。如果沒在執行,點選 Start MCP Server。
外掛的這個分頁裡可以開啟選用功能,例如 Poly Haven、Poly Pizza(需要免費 API key)和各種 3D 生成器。
如果 agent 連不上:確認 Blender 已開啟且外掛在執行,而且不要自己在終端機裡啟動 uvx mcp-for-blender(README 的疑難排解表裡這麼要求)。從 Dock 或開始功能表啟動的應用程式可能找不到 uvx,出現 spawn uvx ENOENT。解決辦法是把 which uvx(macOS/Linux)或 where uvx(Windows)給出的完整路徑當作指令。還是不行的話,重新啟動 agent 和 Blender。
完整範例:從提示詞到 three.js 的低多邊形遊戲道具
目標:替網頁遊戲做一個寶箱,體積小、載入快,格式能被 three.js 直接讀取。這套流程是我們根據文件寫的,沒有完整跑過一遍,所以檔案大小和實際結果會有差異。
1. 先儲存你的 Blender 檔案
新建一個 Blender 檔案,在 agent 開始前先儲存(例如 chest.blend)。agent 會直接修改你的檔案,README 自己的警告就是務必先儲存。
2. 給 agent 下提示詞
在 Claude Code 或 Codex 裡,Blender 已開啟並連接:
Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
(dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.
這個提示詞裡有幾個選擇對遊戲很重要。純基礎色匯出最乾淨,因為 glTF 匯出器從 Principled BSDF 節點取基礎色,見 Blender 的 glTF 手冊。合併成一個物件,在 three.js 裡就是一個 mesh。原點放在底部,設定 y = 0 時寶箱就落在地面上。限定三角面數,能防止 agent 加細分。
3. 匯出這一步
Blender Python 由 agent 來寫。匯出通常以類似下面的呼叫結尾,用的是 Blender 的 export_scene API 文件裡的參數:
import bpy
bpy.ops.export_scene.gltf(
filepath="/path/to/your-game/public/models/chest.glb",
export_format='GLB', # single binary file: mesh, materials and images packed together
use_selection=True, # only the selected "Chest" object
export_apply=True, # apply modifiers on export
export_yup=True, # glTF's +Y up convention, which three.js also uses
)
和 agent 執行的每個腳本一樣,核准之前先讀一遍。檢查路徑指向你專案裡面,而且沒有刪除或覆寫你在意的檔案。
4. 用 glTF-Transform 壓縮 GLB
glTF-Transform 是最佳化 glTF 檔案的命令列工具。安裝後執行 optimize。下面是它 README 裡的指令:
npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp
對我們的寶箱:
gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp
optimize 預設用 meshopt 壓縮幾何(--compress meshopt),把貼圖限制在 2048 px 以內,並攤平場景圖。我們的寶箱沒有圖片貼圖,所以 --texture-compress webp 在這裡沒有作用,但帶貼圖的道具建議保留。如果只想壓縮幾何,glTF-Transform 還有 gltf-transform meshopt input.glb output.glb --level medium。
5. 在 three.js 裡載入
meshopt 壓縮過的檔案需要 meshopt 解碼器。沒有它,GLTFLoader 會丟出「setMeshoptDecoder must be called before loading compressed files」。下面的 import 是 three.js 自己的範例裡用的:
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);
const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);
Blender 用公尺當單位,多數 three.js 場景也是,所以寶箱載入後應該大約 1 m 寬。如果它是躺倒的,多半是匯出時沒開 export_yup。如果是黑的,表示場景需要燈光:加一個 HemisphereLight 或環境貼圖。
6. 反覆調整
保持 Blender 檔案開啟,請 agent 繼續改,例如「讓蓋子打開 40 度,並做成名為 Lid 的獨立物件」或「在裡面加一堆金幣」。然後重新執行匯出和 optimize 指令。請 agent 把匯出腳本保存在你的專案裡,每次就能用同樣的設定。
限制與安全
- **它能在 Blender 裡執行任何 Python。**README 的警告是:「The
execute_blender_codetool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous.」Blender 裡的 Python 能讀寫你的使用者帳號能存取的任何檔案。請 agent 在執行前先顯示腳本,並且自己讀一遍。 - 每次使用前先儲存檔案。同一段警告的結尾是:「ALWAYS save your work before using it.」邊做邊儲存版本(File → Save Incremental)。
- **不需要檔案或網路存取時,開啟安全模式。**替伺服器設定
BLENDER_MCP_SAFE_MODE=1。之後每個腳本執行前都會被檢查,直接讀寫檔案、執行其他程式、使用網路,或在腳本結束後繼續執行的程式碼都會被擋下。建模、材質、算圖、儲存和匯入/匯出仍然可用。 - 只在 localhost 上使用。外掛的 socket 沒有驗證,也沒有加密。能連到那個連接埠的人都能在你的 Blender 裡執行 Python。不要把它暴露給你不信任的網路。
- 把大任務拆成步驟。README 說複雜操作可能需要拆小,逾時靠簡化請求來解決。Poly Haven 的下載在 Blender 主執行緒上執行,所以下載完成前 Blender 會卡住。
- **檢查素材授權。**Poly Haven 是 CC0。Poly Pizza 約 69% 是 CC-BY,需要標示作者。外掛會把標示行寫到匯入的物件上,你也可以用
licence="CC0"搜尋。 - **遙測。**預設情況下,伺服器會送出一筆匿名使用紀錄:安裝 ID、工作階段 ID、工具名稱、是否成功、耗時、版本、作業系統和時間戳記。只有你主動選擇加入,才會收集你的提示詞、程式碼、截圖和場景資料。
DISABLE_TELEMETRY=true會把這些全部關掉。
Blender MCP 的替代方案
- Blender Lab 的 Blender MCP:Blender 自己的伺服器。它更小,圍繞 Python API 文件、場景和檔案摘要、截圖以及執行程式碼來做,包括針對
.blend檔案的背景模式。它需要 Blender 5.1+,採用 GPL-3.0。它的 wiki 裡的設定方式是複製儲存庫,再用uv --directory .../blender_mcp/mcp run blender-mcp執行。如果你想用官方專案,又不需要素材搜尋或 AI 模型生成,就選它。 - Blender Agent Skills:28 個針對 Blender 5.2 LTS+ 的 skill(建模、UV、烘焙、綁定、動畫、最佳化、匯出),適用於 Claude Code、Codex、OpenCode、Gemini CLI、Copilot 和 Cursor。MIT。Skill 教 agent 怎麼做事,MCP 伺服器讓它能控制 Blender。兩者可以一起用。
- blender-game-skills:把概念圖做成帶綁定、可直接用於遊戲的 3D 素材的 Claude Code skill。MIT。
- 現成的模型。常見道具直接用免費模型往往比生成更快。見 Polyfork 的低多邊形 GLB。
我們的遊戲開發 agent skill 和 MCP 伺服器清單介紹了 Godot、Unity、Unreal 和 three.js 上對應的工具。
常見問題
Blender MCP 免費嗎?
免費。MCP for Blender 採用 MIT 授權,外掛免費。它的 Premium 頁面說所有功能在免費版都能用,只有 3D 生成要付費。你可以用自己的 API key 接 Meshy、Tripo、Hunyuan3D、Hyper3D Rodin 或 World Labs,也可以買 Premium(2026 年 11 月 21 日起每月 10 美元起)免 key 使用。Blender Lab 的伺服器採用 GPL-3.0,也免費。你的 AI agent 的訂閱或 API 費用仍然要另付。
Blender MCP 安全嗎?
取決於你讓它執行什麼程式碼。agent 在 Blender 裡執行 Python,這些 Python 擁有你的使用者對檔案的存取權限。先儲存工作,核准前先讀腳本,使用安全模式(BLENDER_MCP_SAFE_MODE=1),並讓外掛的連接埠只在 localhost 上。請從官方儲存庫或專案自己的安裝腳本安裝,不要用別人轉傳的副本。
有官方的 Blender MCP 伺服器嗎?
有。Blender Lab 在 projects.blender.org/lab/blender_mcp 發布了一個,Claude 的連接器目錄裡以「Blender」之名列出,作者是 Blender Lab。更出名的 MCP for Blender(原名 blender-mcp)是第三方專案,與 Blender Foundation 沒有關聯。
Blender MCP 能搭配 Claude Code 用嗎?
可以。執行 claude mcp add blender uvx mcp-for-blender,開啟已啟用外掛的 Blender,再用 claude mcp list 檢查。Claude Desktop 則是在 claude_desktop_config.json 裡加一段 JSON 來設定。
Blender MCP 能搭配 Codex 用嗎?
可以。執行 codex mcp add blender -- uvx mcp-for-blender,或是把 [mcp_servers.blender] 加到 ~/.codex/config.toml。README 還提供一個 Codex 外掛,可以在聊天旁顯示即時的 Blender 視埠。
Blender MCP 能搭配 ChatGPT 用嗎?
README 列出的是桌面端和寫程式類用戶端(Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、OpenCode、Antigravity),沒有 ChatGPT 應用程式。OpenAI 做這類事用的是 Codex。伺服器要連接的是你自己電腦上執行的 Blender,所以需要一個能啟動本機 MCP 伺服器的用戶端。
Blender MCP 的分頁在哪?
在 Blender 的 3D 視埠裡按 N 開啟側邊欄,分頁叫 MCP for Blender。如果沒有,在 Edit → Preferences → Add-ons 裡啟用 Interface: MCP for Blender。
用 Blender MCP 還是 Blender skill?
MCP 伺服器讓 agent 能操作一個執行中的 Blender:建立物件、查看視埠、匯出。Skill 教 agent Blender 的工作流程和慣例,不管它之後是透過 MCP 還是在命令列裡無介面執行 Blender,都有幫助。做遊戲素材時,兩者一起用效果不錯。MCP 伺服器負責建模,Blender Agent Skills 這樣的 skill 套件負責 UV、最佳化和匯出設定。
來源
2026 年 11 月 21 日核對:mcp-for-blender README、MCP for Blender Premium、Blender Lab blender_mcp及其設定 wiki、Claude Code MCP 文件、Codex MCP 文件、Blender export_scene API、Blender glTF 2.0 手冊、glTF-Transform CLI、three.js GLTFLoader。



