MCPBlender/blender-mcp · 上手攻略

  • 仓库：MCPBlender/blender-mcp
  • 链接：https://github.com/MCPBlender/blender-mcp
  • 分类：MCP · AI Agent 工具链
  • 作者：Tom
  • 更新：2026-08-09

这是什么

BlenderMCP 将开源 3D 创作软件 Blender 接入 Model Context Protocol（MCP），使 AI（默认 Claude，亦可接任意 MCP 兼容客户端）通过自然语言直接操控 Blender 的 3D 场景：创建/移动/缩放物体、应用材质、编写 Python 脚本、截图Viewport、下载 HDRI 背景……本质上是一个 Blender 的 AI 遥控桥接层。

解决什么问题：传统 Blender 自动化依赖 Python 脚本或 batch render，门槛高、不直观；BlenderMCP 让"用嘴改 3D 场景"成为现实，尤其适合快速构建场景草稿、批量修改材质、AI 驱动的 3D资产生成管线。

快速安装

环境依赖

要求 最低版本
Blender 3.0+
Python 3.10+
uv 最新版

安装 uv（macOS）:

brew install uv

Linux/Windows 参考 https://docs.astral.sh/uv/getting-started/installation/

步骤 1：添加 MCP Server

在 Claude Desktop（或 Cursor）的 MCP 配置文件 claude_desktop_config.json 中加入：

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

⚠️ 若 uvx 不在 PATH（GUI 客户端不继承终端 PATH），需要用完整路径。例如 macOS/Linux 下先执行 which uvx 获得路径，再替换 command 字段。

Windows 用户建议用：

"command": "cmd",
"args": ["/c", "uvx", "blender-mcp"]

步骤 2：安装 Blender 插件

  1. 下载 addon.py
  2. 打开 Blender → Edit → Preferences → Add-ons → Install → 选择 addon.py
  3. 启用 "Interface: Blender MCP"
  4. 打开 3D View 侧边栏（按 N），切换到 BlenderMCP 标签页
  5. 点击 Connect to Claude，看到 🔨 锤子图标即表示连接成功

步骤 3（可选）：指定 Python 版本

若有多版本 Python 环境，在配置中指定：

"args": ["--python", "3.11", "blender-mcp"],
"env": { "UV_PYTHON_PREFERENCE": "only-managed" }

核心用法

连接成功后，AI 客户端侧会暴露以下工具集（部分）：

工具 作用
create_object 创建立方体、球体、平面等基础物体
move_object 移动物体位置
scale_object 缩放物体
delete_object 删除物体
apply_material 应用材质或颜色
run_python 在 Blender 内执行任意 Python 代码
get_scene_state 查看当前场景所有物体、光源、摄像机状态
viewport_screenshot 截图 Blender Viewport，让 AI"看见"当前画面

典型 prompt 示例（在 Claude 中直接输入）：

Create a low poly dungeon with a dragon guarding gold

Make this car red and metallic

Studio lighting, isometric camera

Create a beach scene with Poly Haven HDRIs, rocks, and vegetation

Poly Haven 资产集成

在 BlenderMCP 侧边栏启用 Poly Haven 后，可直接下载 HDRIs、纹理和 3D 模型，无需手动导入。

AI 3D 模型生成（需配置 API Key）

服务 环境变量 说明
Hyper3D BLENDERMCP_HYPER3D_API_KEY 免费试用有每日限额
Hunyuan3D BLENDERMCP_HUNYUAN3D_SECRET_ID + SECRET_KEY 腾讯混元 3D

配置后 prompt 示例：

Generate a garden gnome with Hyper3D

Sketchfab 模型搜索

设置 BLENDERMCP_SKETCHFAB_API_KEY 后可直接搜索并导入 Sketchfab 模型。

典型适用场景

  1. 快速 3D 场景草稿：用自然语言描述，AI 帮你搭好基础场景，用于概念验证或 pitch deck
  2. 批量修改材质/颜色：一句话改完全部物体的材质，无需手动逐个操作
  3. AI + 3D 资产生成管线：搭配 Hyper3D / Hunyuan3D AI 模型生成资产，再在 Blender 中调整
  4. Blender Python 脚本辅助：描述你想要的效果，AI 编写 Blender Python 代码
  5. 远程 /headless Blender 控制：AI 运行在另一台机器，通过网络控制 Blender

坑与注意

  1. uvx PATH 问题（最常见坑）：GUI 客户端不继承终端 PATH，首次连接失败几乎一定是此原因。用 which uvx 获取完整路径填入 command 字段，或改用 cmd /c uvx（Windows）。

  2. 首次命令常失败：文档明确指出"First command often fails, try again"——这是连接时序问题，重试一次即可。

  3. 同时只运行一个 MCP Server：不要同时在 Claude Desktop 和 Cursor 中开启 blender-mcp，只能二选一。

  4. 复杂操作要拆分：AI 生成完整 3D 场景属于复杂请求，建议拆成"先建物体 → 再加材质 → 再打光"分步进行。

  5. Viewport screenshot 不等于渲染图：截图的是 Blender Viewport 实时画面，不是 Cycles render 结果，AI 看到的画面质量受 Viewport 设置影响。

  6. 远程 Blender：需在启动 Blender 的机器上设置 BLENDER_HOST + BLENDER_PORT，同时确保网络可达（默认 localhost:9876）。

  7. 第三方插件自动化：BlenderMCP 设计目标是 Blender 内置功能 + Browser 内容，对第三方 VST/AU 插件的自动化支持效果不一。

与同类对比

方案 定位 优点 缺点
BlenderMCP AI + Blender 桥接 自然语言控制、资产 AI 生成、多集成 需装插件、稳定性依赖 Blender 版本
直接 Blender Python 脚本 传统自动化 完全控制、灵活 需要写代码、无 AI 理解能力
Blender 内置 Scripting workspace 半自动 自带 IDE、可直接跑脚本 同上
男腔 / OSCP 其他 AI + 3D 方案 专业领域定制 非通用 Blender 控制

BlenderMCP 的核心差异化在于以自然语言为前端，MCP 为协议层，把 Blender 的 Python API 包装成了 AI 可理解的工具集，大幅降低了 3D 场景编程的门槛。

一句话推荐结论

BlenderMCP 是目前将 AI 自然语言控制与 Blender 3D 创作整合最成熟的 MCP 方案，适合需要 AI 驱动 3D 场景搭建、快速原型制作或 AI资产生成管道的开发者，Stars 25,648 也印证了其社区认可度——值得一试，但需注意 uvx PATH 坑和插件安装步骤。

来源：https://github.com/MCPBlender/blender-mcp README + 官方文档