MCP Link Blender

🚀 MCP-Link for Blender

MCP-Link for Blender 能將 Blender 轉變為一個可由人工智能控制的 3D 創作平臺。它通過模型上下文協議（MCP）將 Blender 的整個 Python API 向 AI 代理開放，無需硬編碼命令，提供純粹、通用的 API 訪問，讓 AI 能夠執行 Blender 所能完成的任何操作。

🚀 快速開始

MCP-Link for Blender 藉助模型上下文協議（MCP），把 Blender 的整個 Python API 開放給 AI 代理，讓 AI 可以通過自然語言控制 Blender 進行 3D 創作。

✨ 主要特性

• 開創性的基礎設施：與傳統插件不同，MCP-Link 提供的是一種基礎設施，它就像一座橋樑，能讓任何 AI 代理（如 ChatGPT、Claude、Cursor 或自定義代理）通過自然語言控制 Blender。
• 三個層次的強大功能：
  1. Python 執行：在 Blender 的運行時環境中運行任意 Python 代碼，並擁有完整的 bpy 訪問權限。
  2. 直接 API 調用：執行任何 Blender 操作符或訪問任何數據。
  3. MCP 工具集成：可訪問 10 多種工具（如 SQLite、瀏覽器、AI 模型等）。
• 其他特性：
  • ✅ 100% 通用 API：適用於任何 Blender 命令。
  • ✅ 完整 Python 訪問：運行任意 Python 代碼，具備完整的 bpy 訪問權限。
  • ✅ 持久會話：變量在多個 AI 命令之間保持持久。
  • ✅ MCP 工具生態系統：包含 SQLite、瀏覽器自動化、系統控制等。
  • ✅ 自動連接：擴展程序在啟動時自動連接到 MCP-Link 服務器。
  • ✅ 自動重連：能優雅地處理連接中斷問題。
  • ✅ 線程安全：通過 bpy.app.timers 在主線程執行 Blender API 調用，確保線程安全。

📦 安裝指南

要求

• Blender 4.2+ - 從 blender.org 下載
• MCP-Link 服務器 - 從 AuraFriday 免費下載
• 支持 MCP 的 AI - Cursor、Claude Code 或任何 MCP 客戶端

安裝方法

方法 1：從 Blender 擴展程序安裝

1. 打開 Blender。
2. 轉到 編輯 → 首選項 → 獲取擴展程序。
3. 搜索 "MCP-Link"。
4. 點擊 安裝。

方法 2：從 ZIP 文件安裝

1. 從 發佈頁面 下載 mcp_link_blender-x.x.x.zip。
2. 打開 Blender。
3. 轉到 編輯 → 首選項 → 插件。
4. 點擊 從磁盤安裝...。
5. 選擇 ZIP 文件。

方法 3：命令行安裝

blender --command extension install-file -r user_default -e mcp_link_blender-1.0.0.zip

💻 使用示例

基礎用法

創建一個 3D 立方體

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 1))\nprint(f'Created: {bpy.context.active_object.name}')"
}

創建一個完整的場景

{
  "operation": "execute_python",
  "code": "import bpy\n\n# Clear scene\nbpy.ops.object.select_all(action='SELECT')\nbpy.ops.object.delete()\n\n# Add ground plane\nbpy.ops.mesh.primitive_plane_add(size=10)\n\n# Add a sphere\nbpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 1))\nsphere = bpy.context.active_object\n\n# Add material\nmat = bpy.data.materials.new('Red')\nmat.diffuse_color = (1, 0, 0, 1)\nsphere.data.materials.append(mat)\n\nprint('Scene created!')"
}

渲染到文件

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.context.scene.render.filepath = '/tmp/render.png'\nbpy.ops.render.render(write_still=True)\nprint('Rendered!')"
}

📚 詳細文檔

從源代碼構建

# 克隆倉庫
git clone https://github.com/AuraFriday/mcp_link_blender.git
cd MCP-Link-Blender

# 構建擴展程序
make build

# 安裝到 Blender
make install

Makefile 命令

工作原理

1. 擴展程序加載：Blender 啟動時加載擴展程序。
2. 自動連接：通過 SSE 自動連接到本地 MCP-Link 服務器。
3. 註冊遠程工具：將 "blender" 註冊為遠程工具。
4. 監聽命令：監聽來自 AI 代理的命令。
5. 主線程執行：通過 bpy.app.timers 在主線程執行命令，確保線程安全。
6. 返回結果：將執行結果返回給 AI 代理。

隱私與安全

• ✅ 完全本地運行：所有處理都在本地機器上進行。
• ✅ 無雲依賴：完全離線工作。
• ✅ 無數據收集：您的設計數據不會離開您的計算機。
• ✅ 開源：代碼完全透明，可審計。
• ✅ GPL - 3.0 許可證：自由使用。

故障排除

擴展程序無法連接

1. 確保 MCP-Link 服務器正在運行。
2. 檢查 Blender 的系統控制檯以查看錯誤消息。
3. 驗證服務器是否在預期端口上監聽。

命令無法執行

1. 確保 Blender 處於對象模式以執行大多數操作。
2. 在操作之前檢查所需對象是否存在。
3. 查看響應中的錯誤消息。

🤝 貢獻

歡迎貢獻代碼！請參閱 CONTRIBUTING.md 獲取貢獻指南。

📄 許可證

採用 GPL - 3.0 或更高版本許可證，詳情請參閱 LICENSE。

👏 致謝

由 Aura Friday 創建，此前的插件已獲得 15000 多名用戶的信賴。

鏈接:

• MCP-Link 服務器下載
• GitHub 倉庫
• 問題跟蹤器