Blender MCP

Name: Blender MCP MCP Server
Author: ahujasid

为什么要用

核心特性

直接 bpy 执行——凡是能脚本化的，Claude 都能驱动
场景内省：列出对象、获取属性、检查材质
PolyHaven 集成：搜索并导入 HDRI、纹理、模型
Hyper3D rodin：从文本或图片 AI 生成 3D 模型
内置 Sketchfab 搜索，可浏览免费模型

实时演示

实际使用效果

blender-mcp-ahujasid.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

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

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

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

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

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

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： Blender MCP

从文本 prompt 构建 3D 场景，无需触碰 Blender UI

👤 不擅长建模的设计师、独立开发者和爱好者 ⏱ ~30 min beginner

何时使用： 你需要快速的 3D 场景原型，但不想学 Blender 快捷键。

前置条件

已安装 Blender 3.0+ — 从 blender.org 下载
已启用 Blender MCP 插件 — 编辑 > 偏好设置 > 插件 > 从磁盘安装

步骤

将 Claude 连接到 Blender

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ 已复制

→ 列出空场景（Cube、Camera、Light），确认连接正常
构建场景

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ 已复制

→ 对象实时出现在视口中
添加氛围

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ 已复制

→ 场景有了光照氛围；渲染中可见雾效

结果： 完全通过对话构建的 3D 原型场景，可直接进行精细调整。

注意事项

Blender 会话中途断连 — 从 N 面板重新连接；插件在本地 socket 上监听

用 Hyper3D rodin 生成 3D 素材并直接导入

👤 需要快速迭代素材的游戏开发者和原型设计师 ⏱ ~20 min intermediate

何时使用： 你需要一个独特的道具，但不想从头建模或花钱买市场素材。

前置条件

Hyper3D rodin API key（有免费套餐） — 在 hyper3d.ai 注册；设置 HYPER3D_RODIN_API_KEY

步骤

从 prompt 生成

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ 已复制

→ 生成任务启动；网格完成后导入（约 30 秒）
精细调整并重新导入

The mesh is too dense. Decimate to 5k tris and reimport.✓ 已复制

→ 精简后的网格替换原始网格

结果： 在场景中生成自定义 3D 道具，全程无需离开 Claude。

注意事项

免费套餐的生成队列繁忙 — 使用指数退避重试，或升级套餐

通过 bpy 对大量对象执行批量操作

👤 技术美术和流水线工程师 ⏱ ~25 min advanced

何时使用： 你需要执行繁琐的批量操作——重命名层级、重定向材质、批量 UV 展开。

步骤

描述操作

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ 已复制

→ Claude 编写 bpy 代码片段，询问是否确认执行
在安全网下执行

Show me the script first. If it looks safe, execute. Otherwise revise.✓ 已复制

→ 脚本可见；执行后报告影响了多少对象

结果： 批量场景操作在数秒内完成，并留有完整操作记录。

注意事项

错误的脚本导致 Blender 崩溃 — 任何 bpy 执行前先保存；插件没有沙盒

组合

与其他 MCP 搭配，撬动十倍杠杆

blender-mcp-ahujasid + filesystem

将渲染结果和导出文件保存到磁盘

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
execute_blender_code	code: str	任何直接的 bpy 操作	0
get_scene_info	()	首次调用以了解场景内容	0
get_object_info	name: str	编辑前检查特定对象	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	查找免费 PBR 素材	0
polyhaven_download_asset	asset_id, resolution	拉取并应用 HDRI 或纹理	0
generate_hyper3d_model_via_text	prompt: str	AI 生成 3D 模型	1 generation credit

成本与限制

运行它的成本

API 配额: PolyHaven：无限免费。Hyper3D：免费套餐约每天 20 次生成
每次调用 Token 数: 每次调用 100-800（场景状态可能较冗长）
费用: 插件免费。Hyper3D 付费套餐从 10 美元/月起
提示: 优先使用 Sketchfab 和 PolyHaven，用完再考虑 Hyper3D 付费生成

安全

权限、密钥、影响范围

最小权限： blender-bpy-exec filesystem-write (for downloads)

凭据存储： Hyper3D key 存在环境变量中

数据出站： PolyHaven CDN、Hyper3D API

execute_blender_code 会在你的 Blender 中运行任意 Python——执行来源不明的脚本前请先审查

故障排查

常见错误与修复

Connection refused

确保 Blender 已打开且插件的「Connect to Claude」已开启；默认端口 9876

Hyper3D 生成卡住

检查 HYPER3D_RODIN_API_KEY 环境变量；在 hyper3d.ai 查看套餐配额

编辑后找不到对象

对象名可能带有数字后缀（.001）——使用 get_scene_info 刷新

替代方案

Blender MCP 对比其他方案

替代方案	何时用它替代	权衡
Unity MCP / Unreal MCP	你的流水线以游戏引擎为主，而非 DCC 软件	引擎 MCP 针对运行时/场景；Blender MCP 针对创作阶段
Cesium MCP	你需要地理空间/世界尺度的 3D	Cesium 用于地理参考场景；Blender 用于自由创作

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： Blender MCP

从文本 prompt 构建 3D 场景，无需触碰 Blender UI

前置条件

步骤

注意事项

用 Hyper3D rodin 生成 3D 素材并直接导入

前置条件

步骤

注意事项

通过 bpy 对大量对象执行批量操作

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

Blender MCP 对比其他方案

更多

资源