什么是 mcp-for-blender-pro？
mcp-for-blender-pro 是适用于 Blender 的 AI 助手和模型上下文协议服务器。它可以让 AI 模型检查场景、创建和编辑对象、分配材质、搜索资产、捕获视口图像、查阅 Blender API，以及导出场景。
该扩展面向希望加快迭代速度的艺术家、希望自动化重复工作的技术美术，以及需要将兼容 MCP 的工具连接到 Blender 的开发者。你可以通过 Blender 侧栏操作、打开配套的 Studio 窗口，或连接兼容的外部 MCP 客户端。
Studio 工作区整合了对话历史、场景对象、视口快照、操作审批和任务面板。助手工作时，Blender 仍会保持打开并可正常使用。
主要功能
- 理解 Blender 的智能助手：助手可以在进行更改前检查场景和单个对象。
- 可视化 Studio 工作区：在配套窗口中查看对话、场景数据、任务进度、审批和视口预览。
- 多个 AI 提供商：可使用 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、Ollama 或兼容的自定义 API。
- 已保存的连接：维护独立的连接配置，包括为同一提供商保存多个 API 密钥。
- 单代理和多代理模式：使用一个助手完成快速编辑，或将较大的任务分配给管理者、执行者和审查者。
- 内置 MCP 服务器：连接 OpenCode 及其他支持经过身份验证的可流式传输 HTTP MCP 的客户端。
- 场景和资产工具：使用 21 个工具进行检查、创建、编辑、截图、编写脚本、API 查询、资产处理和导出。
- 多语言界面：主菜单支持英语、德语、法语、西班牙语和中文。
要求
该发布包面向 Windows x64，并要求使用 Blender 4.2 或更高版本。请下载 mcp-for-blender-pro.zip 发布包，不要在安装前解压。
你还需要访问受支持的云服务提供商、安装本地 Ollama、使用兼容的自定义 API，或使用 OpenCode。请选择支持工具调用的模型。如果希望助手理解视口截图，请选择支持图像的模型。
安装 Blender 扩展
从项目的最新版本下载
mcp-for-blender-pro.zip。打开 Blender，选择编辑 → 偏好设置 → 获取扩展。
打开菜单并选择从磁盘安装。
选择下载的 ZIP 文件。
安装后启用 mcp-for-blender-pro。
返回 3D 视图，按下
N，然后打开 MCP Pro 标签页。
使用 Studio 界面或外部 MCP 客户端时，请保持 Blender 运行，因为请求会发送到本地 Blender 连接。
配置 AI 连接
打开 MCP Pro 界面并选择提供商。添加所需的连接信息，加载提供商提供的模型目录，然后选择模型。已保存的连接可以分开保存个人和工作凭据，也可以为一个提供商保存多个账户。
支持的连接选项包括：
- OpenAI
- Anthropic Claude
- Google Gemini
- OpenRouter
- OpenCode Zen
- Ollama
- 兼容的自定义 API
自定义端点可以使用 OpenAI Chat Completions、Anthropic Messages 或 Ollama 协议。仅限 OpenCode 的免费模型需要通过 OpenCode 客户端访问，该客户端会处理自己的提供商登录和模型选择。
使用助手完成第一个场景任务
先从检查请求开始。要求模型在编辑前解释当前场景，可以为它提供有用的上下文，同时让你确认它理解对象结构。
检查此场景，并在进行任何更改前解释其对象结构。确认检查结果正确后，请求执行具体的场景操作：
创建一个简单的产品展示场景，包括一个基座、一台摄像机和三盏灯。为基座赋予哑光蓝色材质。在对话中跟进操作，并在 Blender 或 Studio 视口预览中检查结果。助手可能会使用 add_cube、add_light 和 add_camera 等创建工具，然后使用 move_object 和 set_material 等编辑工具。
编辑现有对象
要进行可预测的编辑，请在 Blender 中选择目标对象，并准确描述排列方式。例如：
将选中的对象复制成整齐间隔的一排，共五个对象，并显示视口。此类任务可以组合使用 duplicate_object、move_object 和 viewport_screenshot。其他编辑工具可以删除对象、创建父子关系或更改材质。
搜索外部资产
该扩展集成了 Poly Haven、Sketchfab 和 Poly Pizza。请在需要时配置服务密钥，并始终遵守每项资产附带的许可协议。
为此场景寻找合适的 Poly Haven 资产，并在导入前询问我。此表述将发现与导入分开，并明确请求批准。相关工具是 search_assets 和 import_asset。
在单个助手和团队之间进行选择
单个助手模式适用于直接提问和快速更改场景。对于更大型的工作流，请配置一个团队链，为各个环节分配独立的职责、指令和模型。
- 管理者：将请求拆分为各项任务，并定义验收标准。
- 执行者：执行分配的场景操作。
- 审核者：检查结果，并批准结果或返回具体发现。
团队任务按顺序运行，以确保编辑顺序保持不变。如果某项任务受阻，将获得一次修正机会。第二次审核失败会停止工作流。使用任务看板监控任务分配、尝试次数和审核发现。
编写有效的团队请求
为团队提供明确的目标、约束条件和预期最终状态。结构化请求可以如下所示：
为选定对象创建产品展示场景。
使用简单的基座和三点照明。
保持现有对象几何形状不变。
完成前检查构图和材质分配。管理者可以将这些要求转化为有序任务，而审核者则使用这些约束作为验收标准。
了解可用的 Blender 工具
内置工具集涵盖以下操作：
- 场景检查：
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。
通常无需在提示词中指定工具名称。清楚描述预期结果，让助手选择合适的操作即可。当你希望限制技术工作流时，指定某个工具仍然很有用。
连接 OpenCode 或其他 MCP 客户端
从 Blender 侧边栏启动OpenCode Portable，即可自动配置 Blender 连接并启动 OpenCode。OpenCode 会自行管理身份验证和模型选择。
其他兼容客户端也可以连接到已通过身份验证的本地 Streamable HTTP MCP 端点。请参阅项目的连接与代理指南，了解端点配置和身份验证详情。客户端连接期间请保持 Blender 开启。
高级工作流技巧
修改前先检查
开始复杂任务时，请先请求 get_scene_info、对象列表或重要对象的详细信息。这样可以减少歧义，并让你有机会在开始修改前纠正假设。
使用视觉验证
在构图、照明或位置发生变化后，请求视口截图。具备图像理解能力的模型可以解读截图，并在审核过程中使用它。
将发现与不可逆操作分开
对于资产导入、删除、脚本编写和导出，请将工作流分为检查和执行阶段。要求助手报告发现的内容，并在继续之前请求批准。
使用明确的验收标准
在团队链中，说明可衡量的要求，例如对象数量、间距、材质分配、摄像机是否存在或是否满足导出条件。具体标准能为审核者提供更清晰的批准依据。
自定义脚本前先查询 API
对于专用场景工具未涵盖的操作，助手可以先通过 bpy_api_lookup 和 describe_node_type 查询 Blender 信息，再使用 execute_code。请仔细审核生成的操作。
安全性、批准和会话行为
内置聊天支持操作批准、在当前步骤完成后取消，以及为场景修改创建带名称的撤销步骤。Python 验证可以检测部分不允许的操作，但它不是安全沙箱。外部 MCP 客户端会应用自己的批准策略。
连接凭据存储在用户设置中，而聊天历史仅在当前会话期间保留。Studio 在本地运行，并对发送到 Blender 的请求进行身份验证。
结论
mcp-for-blender-pro 将 AI 对话、Blender 场景工具、视觉反馈、模型选择和代理工作流整合到一个工作区中。从单个助手和以检查为先的提示词开始，随着工作流变得更加复杂，再采用团队链、资产集成、视口审核和外部 MCP 客户端。
该项目采用 MIT 许可证发布。它是独立项目，与 Blender 基金会或所列 AI 提供商没有关联，也未获得其认可。