Blender MCP 能做什么?19 个内置工具全解析与使用场景
Blender MCP 工具列表详解:场景操作、材质控制、视口截图、AI 生成模型与资源下载能力一览
关键词
Blender MCP、Blender MCP 工具列表、execute_blender_code、Poly Haven、Hyper3D Rodin、Hunyuan3D、AI 3D 建模
摘要
大家好 这里是「代码简单说」,这篇文章主要分享一下 Blender MCP 到底能做什么。我把官方文档里的 19 个工具按场景重新整理了一遍,涵盖场景读取、对象操作、材质、视口截图、代码执行,以及 5 个资源渠道的素材获取,最后说一下它的使用限制,帮你判断它适不适合自己的工作流。
一、Blender MCP 能力总览:6 大类
MCP for Blender 给 AI 客户端提供了一套操作 Blender 的工具集,官方按用途分成 6 类:
- 场景检查:实时读取完整场景图、对象列表、变换信息和集合。
- 对象操作:通过自然语言提示创建、移动、旋转、缩放、重命名、删除对象。
- 材质控制:给场景中任意对象指定和配置材质、贴图、着色器。
- 代码执行:运行任意 Blender Python(bpy),覆盖内置工具没覆盖的操作。
- 资源集成:从 Poly Haven、Sketchfab、Poly Pizza、Hyper3D、Hunyuan3D 搜索和下载 HDRI、贴图、3D 模型。
- 视口截图:截取当前 3D 视口并返回给 AI 客户端,作为视觉反馈。
二、完整工具列表(19 个)
官方文档给出的完整工具表如下:
| 工具 | 分类 | 作用 |
|---|---|---|
get_scene_info | Scene | 返回完整场景图、对象和集合 |
get_object_info | Scene | 按名称返回指定对象的详细数据 |
get_viewport_screenshot | Viewport | 把当前 3D 视口截成图片 |
execute_blender_code | Code | 在 Blender 中运行任意 Python 并返回结果 |
get_polyhaven_status | Asset | 检查 Poly Haven 集成是否启用、可达 |
search_polyhaven_assets | Asset | 在 Poly Haven 搜索 HDRI、贴图或模型 |
download_polyhaven_asset | Asset | 下载 Poly Haven 资源并导入场景 |
set_texture | Material | 给选中对象应用贴图或材质 |
search_sketchfab_models | Asset | 在 Sketchfab 搜索可下载模型 |
download_sketchfab_model | Asset | 下载 Sketchfab 模型并导入场景 |
search_polypizza_models | Asset | 在 Poly Pizza 搜索低多边形模型 |
download_polypizza_model | Asset | 下载 Poly Pizza 模型并导入场景 |
generate_hyper3d_model_via_text | AI | 用 Hyper3D Rodin 从文字生成 3D 模型 |
generate_hyper3d_model_via_images | AI | 用 Hyper3D Rodin 从一张或多张图片生成模型 |
poll_rodin_job_status | AI | 查询 Hyper3D Rodin 生成任务状态 |
import_generated_asset | AI | 把完成的 Rodin 模型导入 Blender |
generate_hunyuan3d_model | AI | 用 Hunyuan3D 从文字或图片生成模型 |
poll_hunyuan_job_status | AI | 查询 Hunyuan3D 生成任务状态 |
import_generated_asset_hunyuan | AI | 把完成的 Hunyuan3D 模型导入 Blender |
规律很清晰:Scene/Material 类负责「改场景」,Asset 类负责「找素材」,AI 类负责「造素材」。找素材的工具都是「搜索 + 下载导入」成对出现,AI 生成类则是「提交任务 → 轮询状态 → 导入」三步走。
三、要素材时怎么选:资源优先级
官方给了一个选型建议,按你要做的东西决定用哪个渠道:
- Sketchfab:找特定、写实、几何和贴图精细的模型。
- Poly Pizza:风格化、低多边形的游戏素材,库里有超过 10600 个免费模型。
- Poly Haven:通用物体、家具、HDRI 和 PBR 贴图。
- Hyper3D Rodin / Hunyuan3D:库里找不到的定制内容。这两个是 AI 生成服务,从文字或图片生成模型。
官方的建议是:优先用库里的现成资源。下载更快,常见物体的质量通常也比生成的模型好。
四、使用限制
三个官方明确提到的限制,用之前要知道:
- 复杂任务要拆步骤。AI 客户端对「增量、明确的指令」响应最好,不要指望一句超长提示词一步到位。
- Blender 必须以 GUI 方式运行。无头模式(
blender -b)不支持,除非用xvfb-run -a blender提供虚拟显示(主要针对 Linux 服务器场景)。 - 只能连接一个 MCP Server 实例。不要同时让 Cursor 和 Claude Desktop 连接同一个 Blender 会话。
五、常见问题
1. AI 生成的模型质量不理想怎么办?
按官方建议,常见物体优先从 Sketchfab、Poly Pizza、Poly Haven 这类现成库里找,AI 生成(Hyper3D Rodin、Hunyuan3D)留给库里没有的定制内容。
2. 服务器上无头运行 Blender 能用吗?
默认不行,blender -b不被支持。Linux 下可以用xvfb-run -a blender起一个虚拟显示来跑。
3. execute_blender_code 有什么风险?
它执行任意 Python,对 Blender 环境有完全访问权限(包括文件系统),执行前记得保存工程文件。
4. 为什么我的工具列表里没有 Poly Haven 相关工具?
资源类工具属于集成功能,需要在 Blender 的 BlenderMCP 侧边栏面板里勾选启用对应集成,启用后才会出现在 AI 客户端的工具列表里(具体步骤见官方文档的集成章节)。
六、总结
Blender MCP 的能力 = 场景读写 + 对象/材质操作 + 截图反馈 + 代码执行兜底 + 5 个资源渠道。日常建模类需求基本都能覆盖,使用时注意拆步骤、保持 GUI 运行、单客户端连接即可。完整工具说明见官方文档 https://mcp-for-blender.com 。
以上就是 Blender MCP 全部内置工具的整理,选用工具时先看高层工具能不能覆盖,再用execute_blender_code兜底。