
mcp-for-blender-pro 可在一个创意工作区中连接 Blender、AI 助手、模型提供商和 Model Context Protocol(MCP)客户端。它可以检查场景、创建和编辑对象、分配材质、搜索资产、捕获视口预览、查询 Blender API 以及导出场景。
本教程将介绍如何安装扩展、配置 AI 连接、发送有效提示词,以及如何通过代理团队或外部 MCP 客户端扩展工作流程。

mcp-for-blender-pro 的功能
该项目为 Blender 添加了 AI 助手,并提供配套的可视化 Studio 工作区。你可以用自然语言描述创意或技术任务,同时让助手使用了解 Blender 的工具检查当前场景并执行已批准的操作。
该扩展适合希望加快迭代速度的艺术家、需要自动化重复工作的技术美术,以及通过 MCP 将 AI 工具连接到 Blender 的开发者。
主要功能
- 场景感知辅助:在进行更改前检查场景和对象。
- 可视化 Studio 工作区:整合聊天、场景对象、视口快照、审批和任务看板。
- 多种 AI 连接:支持 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、Ollama 或兼容的自定义 API。
- 已保存的连接:分开保存工作和个人配置,并为同一提供商存储多个密钥。
- 代理工作流:可使用单个助手,也可以为较大型任务配置管理者、执行者和审查者。
- 内置 MCP 服务器:连接 OpenCode 及其他支持经过身份验证的 Streamable HTTP MCP 的客户端。
- 场景工具:创建、检查和编辑场景,捕获视口内容,搜索资产,查询 Blender API 并导出场景。
- 多语言界面:主界面支持英语、德语、法语、西班牙语或中文。
前置条件和安装
发布包面向 Windows x64,并要求使用 Blender 4.2 或更高版本。开始前,请下载最新的 mcp-for-blender-pro 版本。
- 从 Releases 页面下载
mcp-for-blender-pro.zip。 - 打开 Blender,进入编辑 → 偏好设置 → 获取扩展。
- 打开扩展菜单,选择从磁盘安装。
- 选择下载的 ZIP 文件。
- 启用
mcp-for-blender-pro。 - 在 3D 视口中按
N打开侧栏,然后选择 MCP Pro。
使用 Studio 窗口或外部 MCP 客户端时,请保持 Blender 处于打开状态。该插件在本地运行,并对发往 Blender 的请求进行身份验证。

配置模型连接
启用扩展后,使用 MCP Pro 面板选择提供商,输入所需的连接信息,然后选择模型。你可以加载可用的模型目录,并直接在 Blender 或 Studio 中选择模型。
支持的自定义端点可使用 OpenAI Chat Completions、Anthropic Messages 或 Ollama 协议。请选择支持工具调用的模型。支持图像的模型还可以解读视口截图。

如需本地推理,请连接 Ollama 模型。如需使用托管服务,请配置受支持的云提供商之一。仅限 OpenCode 的免费模型可通过 OpenCode 客户端使用。
连接凭据会存储在用户设置中。聊天记录仅保留在当前会话中,因此如需长期保存,请将重要指令或结果另行保存。
使用助手完成基本的 Blender 任务
选择连接和模型后,在 Blender 中发送消息,或点击打开 Studio 窗口,在可视化工作区中操作。先从检查请求开始,让助手在修改场景前了解其当前状态。
检查此场景,并在进行任何更改前解释其对象结构。
了解场景后,可以要求助手创建一个小型构图。例如:
创建一个简单的产品展示场景,包括一个底座、一台相机和三盏灯。为底座应用哑光蓝色材质。
你还可以请求执行重复的对象操作并获取视觉反馈:

将选中的对象复制成整齐间隔的一排,共五个,并显示视口。
处理外部资产时,可以让助手识别合适的资产,并要求其在导入前征求批准:
为此场景寻找合适的 Poly Haven 资产,并在导入前征求批准。
审查和控制更改
内置聊天支持操作审批、在当前步骤完成后取消,以及针对修改操作的命名撤销步骤。请审查拟执行的操作,并在接受更改前检查视口,尤其是在请求会影响多个对象或材质时。
Python 工具验证有助于捕获不允许的操作,但它不是安全沙箱。外部 MCP 客户端会管理各自的审批策略。
了解可用的场景工具
mcp-for-blender-pro 提供 21 个按用途分组的场景工具。助手可以根据请求处理过程选择这些工具。
- 场景检查:
get_scene_info、list_objects和get_object_info。 - 对象创建:
add_cube、add_sphere、add_cylinder、add_plane、add_light和add_camera。 - 编辑:
move_object、duplicate_object、delete_object、parent_objects和set_material。 - 视觉反馈与脚本编写:
viewport_screenshot和execute_code。 - Blender API 与导出:
bpy_api_lookup、describe_node_type和export_scene。 - 资产工作流:
search_assets和import_asset。
借助这些工具,你可以在一次对话中完成检查、场景编辑、视觉验证、脚本编写、资产查找和导出。
构建多智能体工作流

对于直接的对话式修改,请使用单个助手。对于较大的项目,可以配置团队链,为不同智能体分配独立的职责、指令和模型。

- 管理者:将请求拆分为任务分配和验收标准。
- 工作者:执行分配的场景操作。
- 审查者:检查结果并批准工作,或返回具体的问题发现。
任务按顺序运行,以确保场景编辑保持有序。被阻塞的任务会获得一次修正机会。如果第二次审查仍然失败,工作流将停止。任务面板会随着工作进展显示任务分配、尝试次数和审查结果。
连接外部 MCP 客户端
内置 MCP 服务器支持 OpenCode 及其他兼容客户端,并使用经过身份验证的 Streamable HTTP MCP。你可以从侧边栏启动OpenCode Portable;OpenCode 会自行管理提供商登录和模型选择。
对于其他 MCP 客户端,请参阅项目的连接指南,并使用其中介绍的经过身份验证的本地端点。外部客户端连接期间,请保持 Blender 运行。
负责任地使用资产集成
资产工作流集成了Poly Haven、Sketchfab 和Poly Pizza。在需要时配置服务密钥,并检查你搜索或导入的每个资产的许可协议。
一种实用的工作流是先让助手进行搜索并介绍可用选项,然后在将选定资产导入场景前请求批准。
高级使用技巧
- 编辑前先检查:执行复杂修改前,先请求场景和对象信息。
- 拆分大型需求:当任务包含多个相互依赖的操作时,使用管理者、工作者和审查者。
- 请求视口反馈:在重要修改后,让助手捕获或显示视口。
- 选择具备工具调用能力的模型:自定义模型和托管模型应支持用于场景操作的工具调用。
- 必要时使用具备图像能力的模型:这些模型可以解读视口截图。
- 分离连接:使用已保存的工作连接和个人连接,以便整理凭据和模型选择。
- 审查批准:使用操作批准、取消和命名撤销步骤,持续控制场景修改。
- 检查资产许可:在最终项目中包含外部资产前,确认使用权利。
结语
mcp-for-blender-pro 将 AI 聊天、Blender 场景工具、模型连接、视觉反馈和 MCP 自动化整合到一个工作流中。在 Blender 4.2 或更高版本上安装扩展,配置受支持的提供商或本地 Ollama 模型,然后先从检查提示开始,再进行对象创建、材质设置、资产处理和导出。对于更复杂的生产任务,请使用 Studio 任务面板和智能体角色来组织有序工作与审查。
