什么是 mcp-for-blender-pro？
mcp-for-blender-pro 是一个 Blender 扩展及配套工作区，可将 AI 模型连接到 Blender。它可以检查场景、创建和编辑对象、分配材质、捕获视口截图、搜索和导入资源、查询 Blender API，以及导出场景。
该项目将对话式辅助、模型选择、场景工具、审批和代理工作流整合到一个工作区中。它面向希望自动化处理重复性 Blender 任务，同时继续在 Blender 中审核结果的艺术家、技术美术和开发者。
主要功能
- 理解 Blender 的智能辅助：助手可以在执行操作前检查场景和对象信息。
- Visual Studio 工作区：配套窗口提供聊天、场景对象、视口快照、审批和任务板。
- 多种 AI 连接：使用受支持的 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、Ollama 或自定义 API 连接。
- 已保存的连接：分别保存工作和个人连接，也可以为同一服务商保存多个密钥。
- 单助手或团队工作流：使用一个模型直接进行更改，或配置管理者、工作者和审核者来处理结构化任务。
- 内置 MCP 服务器：连接 OpenCode 以及其他支持经过身份验证的 Streamable HTTP MCP 的客户端。
- 场景工具：项目包含用于检查、创建对象、编辑、视觉反馈、查询 Blender API、导出和资源处理的工具。
- 多语言菜单：主界面支持英语、德语、法语、西班牙语和中文。
要求与安装
该发行包面向 Windows x64，并要求使用 Blender 4.2 或更高版本。请从 GitHub Releases 页面下载最新的 mcp-for-blender-pro.zip 软件包。
- 打开 Blender，选择编辑 → 偏好设置。
- 打开获取扩展，然后打开偏好设置菜单并选择从磁盘安装。
- 选择下载的 ZIP 文件。
- 启用
mcp-for-blender-pro。 - 按
N打开 3D 视口侧栏，然后选择 MCP Pro 面板。
使用 Studio 窗口或外部 MCP 客户端时，请保持 Blender 处于打开状态。有关该仓库的详细设置信息，请参阅快速入门指南。
连接 AI 模型
启用扩展后，在 MCP Pro 面板中选择服务商，输入所需的连接信息并选择模型。之后，你可以直接在 Blender 中发送消息，或点击打开 Studio 窗口来使用可视化工作区。
受支持的自定义端点使用以下协议之一：
- OpenAI Chat Completions
- Anthropic Messages
- Ollama
请选择支持工具调用的模型来执行场景操作。支持图像的模型还可以解析视口截图。仅限 OpenCode 的免费模型可通过 OpenCode 客户端使用。
使用助手执行基本 Blender 任务
先提出一个请求，让助手检查当前场景。这样可以在模型进行任何更改前，验证它是否理解场景。
检查此场景，并在进行任何更改前解释其对象结构。
接下来，你可以用自然语言请求一系列场景操作。例如，助手可以创建一个包含底座、摄像机和灯光的简单产品展示场景，然后分配材质：
创建一个简单的产品展示场景，包含一个底座、一台摄像机和三盏灯。为底座赋予哑光蓝色材质。
其他实用请求包括复制选定对象并在视口中显示结果：
将选定对象复制成整齐间隔的一排五个对象，并显示视口。
你也可以通过对话执行资源工作流。让助手搜索资源，并在导入前请求批准：
为此场景查找合适的 Poly Haven 资源，并在导入前请求批准。
了解可用的场景工具
内置 MCP 服务器提供了围绕常见 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。
资源集成包括 Poly Haven、Sketchfab 和 Poly Pizza。请在需要时配置服务密钥，并遵守所使用每项资源的许可条款。
构建团队工作流
对于快速编辑，请选择 Single assistant。较大的请求可以使用 Team chain，由不同的模型或角色分别负责规划、场景操作和审查。
- 管理者：将请求拆分为任务并定义验收标准。
- 执行者：执行分配的场景操作。
- 审查者：检查结果，并批准工作或返回具体发现。
任务按顺序运行，以确保场景编辑保持有序。如果任务受阻，将获得一次修正机会。第二次审查失败会停止工作流。任务板会随着工作推进显示任务分配、尝试次数和审查发现。
连接外部 MCP 客户端
你可以从侧边栏启动 OpenCode Portable，通过 OpenCode 工作，并自动配置 Blender 连接。OpenCode 负责管理自己的服务商登录和模型选择。
其他兼容的 MCP 客户端可以连接到项目连接与代理指南中所述的已认证本地端点。内置服务器使用经过身份验证的 Streamable HTTP MCP，因此请在配置外部客户端前查看连接说明。
高级用法和安全提示
先检查，再修改
为获得可靠结果，请先要求助手检查场景或选定对象，再请求进行更改。这有助于确定当前对象结构，并减少多步骤提示中的歧义。
请求视觉验证
当任务会改变布局、材质或灯光时，请要求提供视口截图。具备图像理解能力的模型可以解读这些截图，你也可以使用 Studio 预览来检查结果。
对敏感操作使用审批
内置聊天支持操作审批、在当前步骤完成后取消，以及针对修改操作设置命名撤销步骤。当你希望在操作更改场景前进行检查时，请使用这些控件。
了解 Python 验证
Python 工具验证可以帮助捕获不允许的操作，但它不是安全沙箱。请将生成的脚本和场景更改视为需要审查的操作。外部 MCP 客户端负责管理各自的审批策略。
注意凭据和会话
连接凭据存储在你的用户设置中。聊天记录仅在当前会话期间保留，Studio 在本地运行，同时对发往 Blender 的请求进行身份验证。
结语
mcp-for-blender-pro 为 Blender 用户提供了通过对话检查场景、创建和编辑对象、管理材质、使用资源以及自动执行导出的方式。在 Blender 4.2 或更高版本上安装扩展，连接支持工具调用的模型，从检查类提示开始，并随着工作流变得更加复杂，逐步扩展到 Studio、MCP 客户端或经过审查的代理团队。
该项目根据 MIT 许可证发布。发行版中包含 OpenCode 的许可证；该项目独立于 Blender 基金会及所列出的 AI 服务商。