AI 工具 15 min read

Blender MCP 實測:讓 Claude 在 Blender 蓋黃昏日本車站,看圖自己修掉 3 個錯

Blender MCP 是 3.4 萬星的 MIT 開源插件,讓 Claude 把 Python 直接送進 Blender 執行,再用 look 工具多角度截圖檢查自己的成品。我照 IG 爆紅的黃昏車站流程實測,209 個物件、看圖抓出 3 個錯並修好——做得出有氣氛的低多邊形場景,離原作的寫實程度還很遠,而且它能跑任意 Python,動手前一定要存檔。

本文目錄 · 7
懶人包
  • 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 送給插件

截圖回傳

Claude Code

MCP server:mcp-for-blender

Blender 插件:TCP 9876

Blender 場景:執行 Python

我實測的 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 功能表裡「Visual verification」那格寫的是多角度、鏡頭、線框、X 光、動畫條和渲染,讓 AI 自己檢查成品。這一格是整套工具跟「叫 Claude 寫一支 bpy 腳本」最大的差別:模型看得到自己做出來的東西。

怎麼安裝?

前置需求照 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 棵樹
  • 三支鏡頭:月台視角、軌道旁、鳥瞰
灰模用 Workbench 渲染,三張圖的存檔間隔不到 0.4 秒。這一步就抓到第一個問題:鳥瞰鏡頭整個被前景大樓擋住。修正腳本 20 行:把離鏡頭 22 公尺內的大樓刪掉、太靠近軌道的往外推到 24 公尺,鳥瞰鏡頭拉到 (30, -62, 34) 重新對準月台。

用 MCP 的 look 工具(mode=angles)看同一個場景,回傳的是一張四格拼圖:正面、側面、俯視、斜角。

Blender MCP look 工具 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找到根因
灰縫寬度 0.4 比一排磚的高度 0.25 還大,整面取樣到的都是灰縫,所以怎麼改接線都不會亮。最後的修正只有 9 行:
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

前兩輪都在改「結構」(接線、座標),第三輪才去讀「數值」。看圖只告訴你結果不對,看不出是哪個參數錯;這時候叫模型把節點參數印出來,比再猜一輪接法有效。

Blender MCP 建出的黃昏日本車站成品,月台視角,背景大樓窗戶亮燈

成品 209 個物件,RTX 4070 用 Cycles 每張約 8 秒。整個過程留下 6 個階段、每階段 3 個鏡頭的渲染,最後整理成一張對照圖(文章開頭那張)。

跟原作差在哪?

差很多,直接說:我的是低多邊形示意,原作是照片級寫實。從貼文整理的作者說法來看,差距在這幾件事:

項目原作(貼文整理的作者說法)我這次
模型幾乎都由 Claude 建模,Tripo 只用約 5%全部是方塊、圓柱、圓錐組成
看板文字ChatGPT 生的貼圖純色發光面板,沒有字
材質幾乎都用程式算17 種程序材質,細節少
音效HunyuanVideo-Foley沒做
迭代紀錄不清楚6 個階段、每階段 3 個鏡頭的渲染
原作者的 X 原文我搜不到,上表左欄只能算轉述。作者到底接的是不是 Blender MCP、花了多少輪,我都無法確認。

我的判斷:這套工具能做到「一句話出灰模、再一步一步加光線」,對構圖和氣氛的前期試做很夠用;要到原作那個程度,模型細節、貼圖和大量人工判斷都還得補上。

安全設定、限制與踩坑

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 的完整路徑。
Blender 5.3 另外踩到一個跟 MCP 無關的坑:transform_apply(scale=True) 預設也會把位置烘進網格,物件全跑到原點附近。要明確寫 location=False, rotation=False。

這週可以怎麼試?

  1. 先存好你的 .blend 檔,或開一個全新場景。
  2. 跑 uvx mcp-for-blender setup,選 Claude Code,完全重開客戶端,打開 Blender。
  3. 第一句只要灰模:「用方塊和圓柱蓋一個簡單的車站月台,加三支鏡頭:月台視角、軌道旁、鳥瞰。」
  4. 叫它用 look 從三個角度截圖給你看,指出哪裡被擋住、比例不對。
  5. 再一句一句加:天空、太陽角度、燈管、窗戶燈。每一步都叫它渲染一次再看。
  6. 結果不對又找不到原因時,叫它把相關節點的參數印出來,不要讓它一直換接法。
同樣是 Claude 加 Blender,我之前也試過另一種做法:把 PDF 分鏡交給 Claude 寫成一支完整的 bpy 腳本、背景模式直接渲染出動畫,寫在〈Claude 做 3D 動畫:PDF 分鏡寫成 Blender 腳本〉。那條路適合一次寫完、不需要看圖修正的短動畫;這次的 MCP 適合要邊看邊改的場景。

延伸資源

author
陳
陳彥彤

AI 工程師 · AI 顧問。Java 後端 8 年、AI 工程師 2 年。AI 內訓 · AI 導入顧問 · 前後端與雲端培訓。

support

覺得文章有用可以到 GitHub 給個 star,或是透過信箱聊聊 AI 內訓、AI 導入顧問或前後端 / 雲端培訓。