來源：https://blog.csdn.net/2403_87969572/article/details/160531403

抓取時間（ISO本地）：2026-05-18 05:17:46

本文針對已預裝 Blender的使用者，提供保姆級的blender-mcp外掛部署全流程。透過這套方案，你可以直接在用自然語言操控Blender，實現AI自動建模、場景搭建、材質調整、燈光渲染等全流程3D創作，徹底釋放AI在3D設計中的生產力。

前言

blender-mcp是基於Model Context Protocol（MCP協議） 開發的Blender AI整合外掛，它能讓支援MCP協議的AI客戶端（Cursor、Claude等）直接與Blender建立雙向通訊，把大語言模型的程式碼能力和自然語言理解能力，轉化為Blender裡可執行的3D創作指令。

無需手動寫Python指令碼，一句自然語言，就能讓AI幫你完成從基礎建模到完整場景渲染的全流程操作。本文所有步驟均經過實測，跟著操作即可100%完成部署。

一、前置環境校驗

在開始部署前，先確認你的環境滿足最低要求，避免後續出現相容性問題：

1. Blender：3.0及以上版本（推薦4.0+，穩定性更佳）
2. Cursor：最新正式版（已內建MCP協議支援，無需額外安裝外掛）（用別的 trae、claude code、codex也是一樣的，僅配置mcp步驟略有區別）
3. Python：3.10及以上版本（Windows/Mac系統一般預裝，可在終端輸入python --version校驗）
4. 網路環境：能正常訪問GitHub，無特殊網路限制（若有網路問題，可提前配置好終端代理）

二、核心第一步：安裝並配置uv包管理器

這是整個部署流程最關鍵、最優先執行的步驟。blender-mcp的執行完全依賴uvx命令，而uvx是uv包管理器內建的工具，必須先完成uv的安裝和環境配置。

2.1 安裝uv

根據你的作業系統，在對應終端執行安裝命令：

• Windows系統：

  1. 以管理員身份開啟PowerShell（右鍵開始選單→Windows PowerShell(管理員)）
  2. 複製以下命令，回車執行：

     powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
     

  3. 等待執行完成，終端出現安裝成功提示，即完成uv的安裝。

• Mac系統：

  1. 開啟終端，直接執行brew安裝命令：

     brew install uv
     

  2. 等待brew執行完成，無報錯即安裝成功。

安裝之後可以用以下命令檢測是否成功正確安裝

2.2 配置環境變數（Windows必做，Mac可選）

Windows系統安裝完成後，需要手動將uv的安裝目錄新增到系統環境變數，否則終端會提示「uvx不是內部或外部命令」：

1. 開啟PowerShell，依次執行以下2行命令，永久新增環境變數：

   $localBin = "$env:USERPROFILE\.local\bin"
   $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
   [Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")
   

2. 執行完成後，重啟PowerShell/終端，讓環境變數生效。

2.3 驗證安裝是否成功

重啟終端後，執行以下命令，校驗uv和uvx是否正常工作：

uv --version
uvx --version

若終端輸出版本號，無報錯，即說明核心依賴安裝完成；若仍提示命令不存在，重啟電腦後再次校驗即可。

三、第二步：Blender端安裝與配置blender-mcp外掛

3.1 下載外掛核心檔案

blender-mcp的外掛核心是addon.py檔案，有2種獲取方式，任選其一即可：

• 方式一：git克隆（推薦，方便後續更新）

  開啟終端，進入你想存放專案的目錄，執行git克隆命令：

  git clone https://github.com/ahujasid/blender-mcp.git
  

  克隆完成後，開啟資料夾，即可在根目錄找到addon.py檔案。

• 方式二：直接下載單個檔案

  1. 開啟blender-mcp的GitHub倉庫：https://github.com/ahujasid/blender-mcp

     

     按照以上步驟下載壓縮包之後並解壓，確保解壓之後資料夾如下所示

     

注意：若你之前安裝過舊版blender-mcp，需先在Blender中禁用並解除安裝舊版外掛，再安裝新版，避免衝突。

3.2 Blender內安裝外掛

1. 開啟你的Blender軟體，點選頂部選單欄的「編輯(Edit)」→「偏好設定(Preferences)」。

   

2. 在彈出的偏好設定視窗中，左側切換到「外掛(Add-ons)」選項卡。

   

3. 點選視窗右上角的「安裝(Install…)」按鈕，在檔案瀏覽器中，選擇你剛才下載的addon.py檔案，點選「安裝外掛(Install Add-on)」。

   

4. 安裝完成後，在外掛列表中，搜尋「Blender MCP」，會找到名為「Interface: Blender MCP」的外掛，勾選外掛前方的核取方塊，啟用外掛。

   

3.3 驗證外掛載入成功

啟用外掛後，關閉偏好設定視窗，回到Blender的3D檢視介面：

1. 按下鍵盤上的N鍵，調出3D檢視的右側側邊欄。

2. 在側邊欄的標籤中，找到「BlenderMCP」標籤，點選進入，若能看到外掛的控制面板（包含埠設定、連線按鈕、資產開關等），即說明外掛安裝成功。

   

### 3.4 外掛基礎配置

外掛面板中可提前完成全部基礎配置，一次設定長期生效，後續使用無需重複調整，各項配置詳細說明如下：

• 埠(Port)：為Blender外掛與MCP後端服務通訊的本地TCP埠，相當於兩者互聯的專屬通道。預設固定為9876，常規使用無需修改；僅在埠被其他軟體佔用時更換埠，必須保證外掛埠與MCP服務埠完全一致，埠不匹配會導致連線失敗、AI功能全部失效。
• Poly Haven資產：Poly Haven為免費開源3D資源平臺，包含模型、材質、HDRI環境貼圖等素材。勾選對應核取方塊後，AI可自動聯網下載並呼叫該平臺資源，快速搭建完整場景；無需外部資源自動載入時可不開啟，屬於可選配置，關閉不影響外掛核心功能。
• Sketchfab資產：全球大型3D模型共享平臺，擁有海量免費及付費三維資源。開啟該選項可允許外掛呼叫平臺模型，需填寫專屬API Key完成許可權認證，否則會出現訪問限制、呼叫失敗問題，適合需要快速調取特色模型的使用場景。
• Hyper3D Rodin AI生成服務：雲端3D生成工具，支援透過文字描述快速生成三維模型。開啟後可接入官方雲端API，搭配專屬API金鑰解鎖使用額度，同時支援一鍵申領免費試用金鑰，快速啟用AI建模能力。
• 騰訊混元3D生成服務：獨立的AI三維生成方案，可與Hyper3D服務並行啟用。支援本地API部署與雲端接入兩種模式，填寫對應服務地址即可使用；本地部署版本無需聯網、響應更快，無雲端額度限制，兼顧隱私與批次創作需求。
• 八叉樹解析度(Octree Resolution)：控制AI生成模型的體素精度，決定模型細節豐富度與整體面數。數值越高模型細節越精緻，硬體消耗與生成時長越高；數值越低生成速度越快、模型輕量化，適合快速預覽，預設256為均衡引數。
• 推理步數(Number of Inference Steps)：AI建模的迭代打磨次數。步數越高，模型造型越規整、瑕疵越少；步數越低生成效率越快，容易出現模型破損、造型扭曲等問題，可根據畫質需求靈活調整。
• 引導係數(Guidance Scale)：用於平衡AI生成內容與文字描述的貼合度。數值偏高時，生成效果嚴格遵循提示詞要求；數值偏低時AI創作自由度更高，風格更隨機，合理引數可避免模型生硬或偏離需求。
• 生成紋理(Generate Texture)：控制AI是否同步輸出模型材質與紋理貼圖。關閉後僅生成純白模型，執行速度快、效能壓力小；開啟後自動搭配色彩、法線等材質貼圖，一鍵產出成品模型，耗時與硬體佔用會相應增加。
• 斷開MCP伺服器連線：手動切斷外掛與MCP後端的通訊連線，一鍵停用所有AI生成、資源呼叫功能。多用於重啟服務、臨時關閉AI功能的場景。
• 埠執行狀態提示：實時顯示外掛當前監聽執行的埠，用於快速核對埠配置是否正常，直觀確認外掛通訊服務是否成功啟動。
• 遙測設定：用於收集外掛匿名使用資料，輔助開發者最佳化迭代。若注重隱私、拒絕資料上傳，可在外掛偏好設定內取消遙測同意勾選，關閉後不影響外掛所有核心使用功能，為可選配置。

四、第三步：Agent 端MCP服務配置

這一步是建立和Blender通訊的核心，我們提供全域性MCP配置（推薦） 和專案專屬配置兩種方案，任選其一即可。這邊我們以Cursor為例

重要提醒：不要同時在多個客戶端（Claude、Cursor等）執行同一個blender-mcp服務，否則會出現埠占用、連線失敗的問題。

4.1 方案一：全域性MCP伺服器配置（推薦）

全域性配置完成後，你在Cursor中開啟的所有專案，都可以直接使用Blender MCP服務，無需重複配置。

1. 開啟Cursor編輯器，點選左下角的設定圖示，開啟設定面板。

   

2. 在設定面板的左側選單中，找到「MCP」選項，點選進入MCP配置頁面。

   

3. 點選頁面中的「Add new global MCP server（新增新的全域性MCP伺服器）」按鈕，會彈出一個JSON配置編輯框。

   

4. 根據你的作業系統，複製對應的配置程式碼，貼上到編輯框中，點選儲存：

   • 系統配置：

     {
         "mcpServers": {
             "blender": {
       		  "command": "uvx",
       		  "args": ["blender-mcp"]
                 ]
             }
         }
     }
     

5. 儲存配置後，Cursor會自動載入該MCP服務，若配置正確，服務列表中會出現「blender」服，即說明配置成功。

   

4.2 方案二：專案專屬MCP配置

若你只想在特定的Blender專案中使用該AI能力，可選擇專案專屬配置：

1. 在Cursor中開啟你的Blender專案根目錄。
2. 在專案根目錄中，建立一個名為.cursor的資料夾，進入該資料夾，新建一個名為mcp.json的檔案。
3. 開啟mcp.json檔案，根據你的系統，貼上上方4.1中對應的配置程式碼，儲存檔案。
4. 重啟Cursor，重新開啟該專案，配置會自動生效，可在設定的MCP頁面中看到專案專屬的服務。

五、第四步：Blender與Cursor雙向連線與連通性測試

完成以上所有配置後，我們來完成最終的連線，驗證AI是否能正常操控Blender。

5.1 Blender端啟動MCP服務

1. 回到Blender軟體，確保已經啟用了Blender MCP外掛，按下N鍵開啟側邊欄，進入「BlenderMCP」標籤。

2. 確認埠為9876，點選面板中的「Connect to Claude（連線到MCP服務）」按鈕。

   

3. 按鈕下方出現「Running on port 9876」的提示，即說明Blender端的socket服務已成功啟動，正在等待Cursor的連線。

   

5.2 Cursor端驗證工具載入

1. 回到Cursor編輯器，按剛才的方法進入MCP介面

2. 在工具列表中，能看到「blender」分類，點選右側的開啟

   

以下狀態就是對的：

5.3 最簡連通性測試

我們用一條最簡單的指令，驗證AI是否能正常操控Blender：

在Cursor的對話輸入框中，輸入以下指令，傳送給AI：

幫我在Blender場景中，建立一個半徑為2m的球體，再建立一個邊長為1m的立方體，把立方體放在球體的正上方，兩者間距0.5m。

傳送後，AI會自動呼叫Blender MCP工具，向Blender傳送操作指令。

• 若Blender場景中，瞬間出現了對應的球體和立方體，位置完全符合要求，即說明全流程部署成功！

• 若AI提示工具呼叫失敗，可檢視下方的排錯指南，解決對應問題。

  

  

六、常見問題與排錯指南

問題1：終端提示「uvx不是內部或外部命令」

• 原因：uv的安裝目錄未新增到系統環境變數，或環境變數未生效。
• 解決方案：
  1. 重新執行本文2.2中的環境變數配置命令，確保命令執行無報錯。
  2. 重啟終端，甚至重啟電腦，讓環境變數徹底生效。
  3. Windows使用者可手動開啟環境變數編輯器，在使用者變數的Path中，手動新增C:\Users\你的使用者名稱\.local\bin，儲存後重啟電腦。

問題2：Cursor中MCP服務顯示紅色報錯，無法載入

• 原因：配置檔案格式錯誤、uvx命令不可用、網路問題導致blender-mcp包下載失敗。
• 解決方案：
  1. 檢查JSON配置檔案，確保括號、引號完全閉合，無語法錯誤，Windows和Mac的配置不要混用。
  2. 手動在終端執行uvx blender-mcp，若終端無報錯，說明包可正常執行；若報錯，執行uvx --force blender-mcp，強制重新安裝包。
  3. 檢查網路環境，確保能正常訪問PyPI源，可切換國內PyPI映象後重試。

問題3：AI傳送指令後，Blender無任何反應

• 原因：Blender端服務未啟動、埠不匹配、防火牆攔截、多個MCP服務同時執行。
• 解決方案：
  1. 確認Blender端已點選「Connect to Claude」，且提示服務正在執行，埠號和配置檔案中一致。
  2. 關閉Windows防火牆/系統防火牆的攔截，或給9876埠新增防火牆白名單。
  3. 關閉Claude、VS Code等其他客戶端的blender-mcp服務，只保留Cursor中的一個服務執行。
  4. 重啟Blender和Cursor，重新啟動服務後重試。

問題4：Blender中啟用外掛後，側邊欄看不到BlenderMCP標籤

• 原因：Blender版本不相容、外掛安裝失敗、Python環境缺失。
• 解決方案：
  1. 確認Blender版本≥3.0，低於該版本請升級Blender。
  2. 重新下載addon.py檔案，確保檔案下載完整，無損壞，重新安裝外掛。
  3. 開啟Blender的「指令碼」工作區，檢視控制檯是否有報錯，根據報錯資訊排查問題，多數為Python依賴缺失，可手動安裝對應依賴。

七、實戰上手：即用型AI建模Prompt示例

部署成功後，你可以用這些Prompt快速上手，體驗AI驅動3D創作的能力，也可以根據自己的需求修改擴充套件：

1. 基礎場景建模

   幫我在Blender中建立一個低多邊形的森林小場景，包含5棵不同形態的松樹、一個小木屋、一圈木柵欄，地面做草地材質，整體風格統一，面數控制在1萬面以內。

Cursor介面：

Blender介面：

2. 材質與渲染調整

   幫我把場景中的立方體，換成紅色的金屬材質，粗糙度0.1，金屬度0.9，再給場景新增3點布光，主光強度2，補光強度0.5，背光強度0.3，渲染器切換為Cycles，取樣數設定為128。

Cursor介面：

Blender介面：

3. 資產與場景搭建

   幫我從Poly Haven下載一個適合海邊的HDRI環境貼圖，應用到場景中，再下載一個岩石模型和3個不同的海草模型，擺放在場景的前景位置，做出海邊礁石的效果。

Cursor介面：

Blender介面：

4. 動畫與基礎關鍵幀

   在場景中創造一個球體，做一個上下彈跳的迴圈動畫，總時長100幀，彈跳高度3m，在第0幀、50幀、100幀分別設定關鍵幀，再給相機設定一個緩慢環繞的動畫，始終對準球體。

Cursor介面：

Blender介面：

5. 場景資訊與修改

   先獲取當前Blender場景的所有物體資訊，列出每個物體的名稱、面數、位置和材質，然後把所有物體，統一縮放為原來的3倍。

Cursor介面：

Prompt書寫技巧：指令越具體，AI的執行效果越好；複雜場景建議拆分成多個步驟，分多次傳送指令，避免單次指令太複雜導致超時或執行失敗。

八、總結與進階玩法

部署總結

整個部署流程核心只有4步：安裝uv包管理器 → Blender安裝addon外掛 → Cursor配置MCP服務 → 啟動連線並測試。只要嚴格按照步驟操作，就能在10分鐘內完成整個部署，讓你的Blender擁有AI原生創作能力。

進階玩法

1. AI模型生成整合：外掛已支援Hyper3D、混元3D等AI生成模型，可在配置中新增自己的API金鑰，直接用文生3D模型，匯入到Blender場景中。
2. 遠端部署：可將blender-mcp服務部署在遠端伺服器上，修改BLENDER_HOST和BLENDER_PORT環境變數，實現遠端操控Blender。
3. 自定義工具擴充套件：可基於blender-mcp的開原始碼，新增自己需要的Blender操作工具，定製專屬的AI建模能力。
4. 多智慧體協作：在Cursor中配置多個MCP服務，讓AI同時操控Blender、Figma、檔案系統等工具，實現從設計到3D建模的全流程AI自動化。