懶人包
- Blender MCP(ahujasid/blender-mcp,MIT,33,963 星,2026-11-11 查)讓 Claude 把 Python 直接送進 Blender 執行,再截圖回來檢查自己的成品。
- 安裝是一行指令:
uvx mcp-for-blender setup會裝 Blender 插件,也會幫 Claude Code 等客戶端加 MCP 設定;PyPI 套件已從blender-mcp改名為mcp-for-blender。- 我照「先灰模、三個角度檢查、再打光」的順序蓋了一座黃昏車站:209 個物件,RTX 4070 用 Cycles 每張約 8 秒。
- 看圖修正抓到三個問題:鳥瞰鏡頭被大樓擋住、第一輪打光太亮像白天、背景大樓窗戶完全不亮。窗戶那個連改兩輪節點都沒用,最後讀出節點數值才找到根因。
- 成品是低多邊形示意,離原作的寫實程度很遠;原作者的 X 原文我沒查到,所以不確定他用的是不是這套。
- 它能跑任意 Python、socket 沒有驗證:只開在 localhost,動手前先存檔,要保守就設
BLENDER_MCP_SAFE_MODE=1。
這篇起點是一支 Instagram Reel:@your.engineer.ben 介紹日本 3D 藝術家荒船泰廣(@arafune)把 Claude Opus 5.5 接上 Blender,做出一個看起來像實拍的黃昏日本車站。貼文整理了作者的說法:Tripo 自動生模型只用了大約 5%、看板文字貼圖給 ChatGPT 生、材質幾乎都用程式算、音效用 HunyuanVideo-Foley。作者沒說怎麼接,貼文推測是開源的 Blender MCP。
我想知道的是:照這個推測去裝 Blender MCP,一般人能做到哪一步?所以我在 Windows 上裝起來,照貼文建議的順序蓋了一座車站。
Blender MCP 是什麼?
它是一個社群做的 Blender 插件加一支 MCP server,跟 Blender 基金會沒有關係(README 開頭自己寫的)。結構只有兩塊:
| 元件 | 做什麼 |
|---|---|
Blender 插件 addon.py | 在 Blender 裡開一個 socket server(預設 localhost:9876),收 JSON 指令、執行 |
MCP server(uvx mcp-for-blender) | 用 stdio 跟 Claude 講 MCP,再把呼叫轉成 JSON 送給插件 |
我實測的 1.30.0 版一共 9 個工具:
| 工具 | 用途 |
|---|---|
execute_blender_code | 在 Blender 裡跑任意 Python,建模、材質、打光都靠它 |
look | 視覺驗證,模式有 viewport、camera、angles、frames |
get_scene_info | 回報場景裡的物件、鏡頭、燈光 |
generate_3d | 呼叫 3D 生成服務 |
search_assets、import_asset | 找素材、匯入素材 |
get_addon_status | 查插件狀態 |
disable_telemetry、record_trajectory_feedback | 遙測相關 |
怎麼安裝?
前置需求照 README:Blender 3.0 以上、Python 3.10 以上、uv。我用的是 Blender 5.3.0 可攜版、Windows 11。
官方給的一行安裝:
# Windows PowerShell
irm https://www.mcp-for-blender.com/install.ps1 | iex
# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh
已經有 uv 的話,直接跑:
uvx mcp-for-blender setup
README 說它會找出本機的 MCP 客戶端(Claude Desktop、Claude Code、Codex、Cursor、VS Code 等)讓你選,只加一個 blender 項目、改過的設定檔都留 .bak,再把 Blender 插件裝好並啟用。裝完要完全關掉 AI 客戶端再開,然後打開 Blender。
只想手動接 Claude Code,一行就好:
claude mcp add blender uvx mcp-for-blender
我這次沒有跑 setup,也沒有 claude mcp add:這兩個都會改 Claude Code 的全域設定,我想先在隔離環境驗證。做法是把插件裝進可攜版 Blender,自己寫一支 20 行的 stdio 客戶端去啟動 uvx mcp-for-blender,走 initialize → tools/list → tools/call。實際回應:
server: MCP for Blender 1.30.0
tools: execute_blender_code, look, get_scene_info, generate_3d, search_assets,
import_asset, get_addon_status, disable_telemetry, record_trajectory_feedback
get_scene_info -> 3 支鏡頭、22 盞燈、209 個 mesh
這證明 MCP 這條路是通的。建模的那些 Python 是 Claude Code 寫好後,透過插件同一套 JSON 協定({"type": "execute_code", "params": {"code": ...}})直接送進 9876 port;正式接進 Claude Code 後,走的就是 execute_blender_code 這個工具。
我怎麼蓋這座車站?
順序照 Reel 建議的來:先灰模,三個角度看一次,再一步一步加光線和細節。
第一步:灰模加三支鏡頭
第一支腳本 121 行,蓋出:
- 8×90 公尺月台、1067mm 軌距雙軌、330 根枕木
- 11 根柱子、84 公尺屋頂、架空線
- 48 棟背景大樓、20 棵樹
- 三支鏡頭:月台視角、軌道旁、鳥瞰
(30, -62, 34) 重新對準月台。
用 MCP 的 look 工具(mode=angles)看同一個場景,回傳的是一張四格拼圖:正面、側面、俯視、斜角。
這張圖是模型「自己看成品」的依據。俯視那格看得出月台在兩條軌道正中間、樹沿軌道兩側排,斜角那格看得出前景大樓多高。
第二步:黃昏打光
打光腳本 158 行:17 種程序材質、21 根日光燈管、物理天空(Blender 5.3 的 Sky 節點類型叫 MULTIPLE_SCATTERING)、低角度太陽。渲染改用 Cycles。
第一輪渲染出來太亮,像下午。調整腳本 32 行:曝光降到 -1.3、太陽仰角壓到 0.6 度、太陽光改成偏橘的 (1.0, 0.42, 0.15)。看板下方加一條深綠色的條,讓它看起來是站名牌而不是白色箱子。
第三步:窗戶不亮,修了三輪
第一輪打光後,背景大樓的窗戶是全黑的。窗戶是用 Brick 紋理當遮罩:磚塊是亮的窗、灰縫是暗的牆。
| 輪次 | 改了什麼 | 結果 |
|---|---|---|
| 1 | 拿掉中間的 Mix 節點,磚塊顏色直接接 Emission Color | 還是黑的 |
| 2 | 紋理座標改成 (x+y, z),讓磚塊貼在垂直立面上 | 還是黑的 |
| 3 | 讀出節點數值:Mortar Size 0.4,Row Height 0.25 | 找到根因 |
import bpy
nt = bpy.data.materials['FacadeWindows'].node_tree
br = next(n for n in nt.nodes if n.type == 'TEX_BRICK')
br.inputs['Mortar Size'].default_value = 0.08
br.inputs['Row Height'].default_value = 0.3
br.inputs['Bias'].default_value = 0.35
nt.nodes['Principled BSDF'].inputs['Emission Strength'].default_value = 4
前兩輪都在改「結構」(接線、座標),第三輪才去讀「數值」。看圖只告訴你結果不對,看不出是哪個參數錯;這時候叫模型把節點參數印出來,比再猜一輪接法有效。
成品 209 個物件,RTX 4070 用 Cycles 每張約 8 秒。整個過程留下 6 個階段、每階段 3 個鏡頭的渲染,最後整理成一張對照圖(文章開頭那張)。
跟原作差在哪?
差很多,直接說:我的是低多邊形示意,原作是照片級寫實。從貼文整理的作者說法來看,差距在這幾件事:
| 項目 | 原作(貼文整理的作者說法) | 我這次 |
|---|---|---|
| 模型 | 幾乎都由 Claude 建模,Tripo 只用約 5% | 全部是方塊、圓柱、圓錐組成 |
| 看板文字 | ChatGPT 生的貼圖 | 純色發光面板,沒有字 |
| 材質 | 幾乎都用程式算 | 17 種程序材質,細節少 |
| 音效 | HunyuanVideo-Foley | 沒做 |
| 迭代紀錄 | 不清楚 | 6 個階段、每階段 3 個鏡頭的渲染 |
我的判斷:這套工具能做到「一句話出灰模、再一步一步加光線」,對構圖和氣氛的前期試做很夠用;要到原作那個程度,模型細節、貼圖和大量人工判斷都還得補上。
安全設定、限制與踩坑
README 的 Limitations 段落用粗體寫了:ALWAYS save your work before using it. 原因很直接,execute_blender_code 可以跑任意 Python。
README 和實測確認的事:
- socket 沒有任何驗證,誰連得上 9876 port 都能送程式碼進去執行。只能開在 localhost,不要對外開放這個 port。
BLENDER_MCP_SAFE_MODE=1會在執行前檢查腳本,擋掉直接讀寫檔案、跑其他程式、連網路這類操作;建模、材質、渲染、存檔、匯入匯出照常能用。被擋的腳本會連同原因回給 AI 重寫。- 遙測:README 寫內容蒐集預設關閉、要自己勾選才開;但預設仍會送最少量的匿名使用紀錄(安裝 ID、工具名稱、成功與否、版本、作業系統)。要完全關掉,設環境變數
DISABLE_TELEMETRY=true。 - 插件在
blender -b背景模式下不會啟動 socket,一定要開 Blender 視窗。 - GUI 啟動的客戶端可能找不到
uvx:README 寫 Claude Desktop 這類從開始選單開的程式不繼承終端機的 PATH,會出現spawn uvx ENOENT,要改用uvx的完整路徑。
transform_apply(scale=True) 預設也會把位置烘進網格,物件全跑到原點附近。要明確寫 location=False, rotation=False。
這週可以怎麼試?
- 先存好你的
.blend檔,或開一個全新場景。 - 跑
uvx mcp-for-blender setup,選 Claude Code,完全重開客戶端,打開 Blender。 - 第一句只要灰模:「用方塊和圓柱蓋一個簡單的車站月台,加三支鏡頭:月台視角、軌道旁、鳥瞰。」
- 叫它用
look從三個角度截圖給你看,指出哪裡被擋住、比例不對。 - 再一句一句加:天空、太陽角度、燈管、窗戶燈。每一步都叫它渲染一次再看。
- 結果不對又找不到原因時,叫它把相關節點的參數印出來,不要讓它一直換接法。
延伸資源
- GitHub ahujasid/blender-mcp:README 的 Quickstart、Safe mode、Telemetry Control 三段是這篇引用的來源
- 這次的成果頁:各階段三個鏡頭的渲染都在上面
- Claude 做 3D 動畫:PDF 分鏡寫成 Blender 腳本:不接 MCP、一支 bpy 腳本直接渲染動畫的做法