MCP Blend

🚀 MCP-Blender 服務器 for Blender

MCP-Blender 服務器藉助 Model Context Protocol 實現了 Blender 與 Claude AI 的對接，讓 Claude 能夠直接與 Blender 交互和控制，實現快速、自然的 3D 模型創作，還支持參數化設計和關聯式設計。未來還計劃推出適用於 CATIA、SolidWorks 等其他 CAD 軟件的 MCP-Server。

🚀 快速開始

MCP-Blender 服務器通過 Model Context Protocol 達成 Blender 和 Claude AI 的對接，使 Claude 可直接與 Blender 交互控制，實現 3D 模型的快速自然創作，支持參數化與關聯式設計。

✨ 主要特性

1. 軟件連接：使用 MCP 將 Blender 等 CAD 軟件與服務器連接。
2. 模型創建：在 Blender 中創建模型。
3. 代碼執行：在 Blender 中執行臨時代碼。

📦 安裝指南

安裝步驟 #1：安裝 UV Package

1. 安裝 UV 和 UVX

   pip install uv 
   

   • 參考文檔：https://docs.astral.sh/uv/getting-started/installation/#__tabbed_1_2

2. 檢查安裝版本

   uv --version
   uvx --version 
   

3. 安裝路徑檢查

   • 如果在虛擬環境中安裝，請建議指定完整路徑的方法

   # 安裝路徑檢查 
   where uvx 
   

4. 克隆代碼庫或下載文件夾

   git clone https://github.com/piolla/mcp-blend
   cd mcp-blend
   

安裝步驟 #2：Blender 插件

1. 下載 blender_addon.py 文件。
2. 打開 Blender：
   • 轉到菜單欄的 Edit -> Preferences -> Add-ons -> Inrell Add-on，然後選擇下載的 blender_addon.py 文件路徑。
   • 激活插件：勾選 Interface: Blender MCP 複選框。

安裝步驟 #3：Claude AI 配置

1. 打開 Claude AI。

2. 進入菜單欄的 文件 -> 設置 -> 開發者 -> 設置編輯：

   • 在文件瀏覽器中找到並修改 claude_desktop_config.json 文件，參考以下內容進行配置

   {
       "mcpServers":
       {
           "Blender":
           {
               "command": "D:\\Anaconda\\envs\\aria\\Scripts\\uvx.exe",
               "args": ["blender-mcp" ]
           }
       }
   }
   

3. 保存修改後，退出並重新啟動 Claude AI：

   • 在文件菜單中選擇 退出。
   • 再次啟動 Claude AI 並檢查連接狀態。

🔧 技術細節

需要的組件

1. Blender （版本 3.5 或更高）
2. Claude AI
3. Python （版本 3.10 或更高）
4. UV Package

📄 許可證

文檔未提及相關許可證信息。

⚠️ 重要提示

• Blender 版本變化可能導致無法正常運行。此外，可能會執行任意 Python 代碼，存在潛在風險。
• 如果不再使用，請在 Blender 的編輯界面中禁用 Blender MCP 功能。

💡 使用建議

blender_addon.py 是 Siddharth（https://x.com/sidahuj）先生編寫的作品，在此表示感謝。