关键词

3D建模Blender控制AI助手几何编辑雕刻工具

项目简介

Blender AI MCP 服务器是一个基于 Model Context Protocol (MCP) 的桥接工具，让大型语言模型（如 Claude、ChatGPT）能够可靠地操作 Blender 进行 3D 建模。它解决了传统 AI 直接编写 Python 脚本控制 Blender 时的多种问题，包括 API 过时、上下文错误、无反馈循环和安全风险。

主要功能

核心建模功能

  • 场景管理：创建、删除、重命名对象，管理视图和相机
  • 几何编辑：挤出、倒角、环切、布尔运算等核心建模工具
  • 材质与纹理：创建 PBR 材质，绑定图像纹理
  • UV 映射：展开、打包、创建接缝
  • 雕刻工具：平滑、抓取、捏合、膨胀等有机建模
  • 导入导出：支持 OBJ、FBX、GLB 等主流 3D 格式
  • 骨骼绑定：创建骨架，绑定网格，权重绘制

高级特性

  • 智能路由器：自动纠正错误的工具调用，扩展单步操作为完整工作流
  • 网格分析：拓扑检测、对称性分析、多角度渲染

安装步骤

1. 安装 Blender 插件

  • 从 GitHub Releases 页面下载 'blender_ai_mcp.zip'
  • 打开 Blender → 编辑 → 首选项 → 插件
  • 点击"安装..."选择 zip 文件并启用插件

2. 配置 MCP 客户端

推荐使用 Docker 运行 MCP 服务器。以下是主要 MCP 客户端的配置示例：

Cline / Claude Code 配置

  • 配置文件：'cline_mcp_settings.json'
  • 服务器配置信息：
{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e", "BLENDER_RPC_HOST=host.docker.internal",
    "ghcr.io/patrykiti/blender-ai-mcp:latest"
]

关键环境变量说明：

  • 'BLENDER_RPC_HOST'：连接 Blender 的主机地址
    • macOS/Windows：使用 'host.docker.internal'
    • Linux：使用 '--network host' 和 '127.0.0.1"

使用方法

  1. 启动 Blender 并确保插件已启用
  2. 配置 MCP 客户端 使用上述 Docker 配置
  • 插件会自动在端口 8765 启动本地服务器
  • AI 助手可以通过 MCP 协议调用各种建模工具

常用工具示例：

  • 'modeling_create_primitive'：创建立方体、球体等基本几何体
  • 'mesh_extrude_region'：挤出选中的面
  • 'scene_get_viewport'：获取当前视图截图
  • 'material_create'：创建新的 PBR 材质
  • 'sculpt_brush_smooth'：平滑雕刻

信息

分类

桌面与硬件

访问项目