/ 目錄 / 演練場 / Blender MCP
← 全部伺服器 ↗ GitHub
● 社群 ahujasid ⚡ 即開即用

Blender MCP

作者 ahujasid · ahujasid/blender-mcp

透過 Claude 驅動 Blender——從對話中建模 3D 場景、執行 Python 操作、取得 PolyHaven HDRI 與 Hyper3D rodin 資產。

Blender MCP 透過 Python 附加元件將 Claude 連接到正在執行的 Blender 實例。Claude 可以內省場景、操作物件、執行任意 Blender Python（bpy）、設定材質，並從 PolyHaven 取得免費 PBR 資產，以及從 Hyper3D 取得 AI 生成的 3D 模型。最初因從文字提示生成完整場景而廣為流傳。

▶ 觀看演示 📦 安裝 💡 使用場景

為什麼要用

核心特性

即時演示

實際使用效果

blender-mcp-ahujasid.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： Blender MCP

從文字提示建立 3D 場景，無需接觸 Blender 介面

👤 不擅長建模的設計師、獨立開發者和愛好者 ⏱ ~30 min beginner

何時使用： 你想要快速的 3D 場景原型，但不想學 Blender 快捷鍵。

前置條件
  • 已安裝 Blender 3.0+ — 從 blender.org 下載
  • 已啟用 Blender MCP 附加元件 — 編輯 > 偏好設定 > 附加元件 > 從磁碟安裝
步驟
  1. 將 Claude 連接至 Blender
    Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ 已複製
    → 列出空場景（Cube、Camera、Light），確認即時連線
  2. 構建場景
    Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ 已複製
    → 物件即時出現在視埠中
  3. 添加氣氛
    Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ 已複製
    → 場景現在有光線氣氛；霧氣在渲染中可見

結果： 完全透過對話建立的 3D 場景原型，可進一步精修。

注意事項
  • Blender 在工作階段中途斷線 — 從 N 面板重新連線；附加元件監聽本地 socket

使用 Hyper3D rodin 生成 3D 資產並直接匯入

👤 需要快速資產迭代的遊戲開發者和原型製作者 ⏱ ~20 min intermediate

何時使用： 你需要一個獨特的道具，不想從頭建模，也不想花錢買市場上的資產。

前置條件
  • Hyper3D rodin API 金鑰（提供免費方案） — 在 hyper3d.ai 註冊；設定 HYPER3D_RODIN_API_KEY
步驟
  1. 從提示生成
    Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ 已複製
    → 生成任務啟動；完成後匯入網格（約 30 秒）
  2. 按需精修並重新匯入
    The mesh is too dense. Decimate to 5k tris and reimport.✓ 已複製
    → 精簡後的網格取代原始網格

結果： 自訂 3D 道具出現在場景中，無需離開 Claude 即可生成和調整。

注意事項
  • 免費方案的生成佇列繁忙 — 以指數退避重試，或升級方案

透過 bpy 對多個物件執行批次操作

👤 技術總監和管線工程師 ⏱ ~25 min advanced

何時使用： 你需要繁瑣的批次動作——重新命名層級、重新指定材質、批次 UV 展開。

步驟
  1. 描述操作
    Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ 已複製
    → Claude 撰寫 bpy 片段，執行前要求確認
  2. 搭配安全網執行
    Show me the script first. If it looks safe, execute. Otherwise revise.✓ 已複製
    → 腳本可見；執行套用；回報受影響物件數量

結果： 批次場景操作在數秒內完成，並有完整稽核記錄。

注意事項
  • 錯誤的腳本導致 Blender 崩潰 — 在任何 bpy 執行前儲存；附加元件不提供沙箱保護

組合

與其他 MCP 搭配，撬動十倍槓桿

blender-mcp-ahujasid + filesystem

將渲染和匯出儲存到磁碟

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
execute_blender_code code: str 任何直接的 bpy 操作 0
get_scene_info () 首次呼叫以了解場景內容 0
get_object_info name: str 編輯前檢查特定物件 0
polyhaven_search_assets asset_type: hdri|model|texture, categories? 尋找免費 PBR 資產 0
polyhaven_download_asset asset_id, resolution 拉取並套用 HDRI／貼圖 0
generate_hyper3d_model_via_text prompt: str AI 生成 3D 模型 1 generation credit

成本與限制

運行它的成本

API 配額
PolyHaven：無限免費。Hyper3D：免費方案約每天 20 次生成
每次呼叫 Token 數
每次呼叫 100–800（場景狀態可能較冗長）
費用
附加元件免費。Hyper3D 付費方案從 10 美元／月起
提示
在使用 Hyper3D 付費生成前，先使用 Sketchfab 和 PolyHaven

安全

權限、密鑰、影響範圍

最小權限： blender-bpy-exec filesystem-write (for downloads)
憑證儲存： Hyper3D 金鑰存於環境變數
資料出站： PolyHaven CDN、Hyper3D API

故障排查

常見錯誤與修復

連線被拒絕

確認 Blender 已開啟，且附加元件的「Connect to Claude」已開啟；預設連接埠為 9876

Hyper3D 生成卡住

檢查 HYPER3D_RODIN_API_KEY 環境變數；在 hyper3d.ai 查看方案配額

編輯後找不到物件

物件名稱可能有數字後綴（.001）——使用 get_scene_info 重新整理

替代方案

Blender MCP 對比其他方案

替代方案何時用它替代權衡
Unity MCP / Unreal MCP你的管線以遊戲引擎為主，而非 DCC引擎 MCP 針對執行期／場景；Blender MCP 針對製作階段
Cesium MCP你需要地理空間／世界規模的 3DCesium 用於地理參照場景；Blender 是自由形式

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills