mcp-for-blender-pro Skill 技能

技能简介

mcp-for-blender-pro 是一款把 Blender 接进 AI 代理工作流的 MCP（Model Context Protocol）服务器 + Blender 插件。它给 Blender 增加了一个可视化 Chat 工作区（Studio），让 OpenAI / Anthropic Claude / Google Gemini / Ollama 等模型可以直接审视你的当前场景、创建对象、编辑材质、查找资产，并执行多步骤任务。插件本身随项目发布 1.0.0 版本，支持 Windows x64 / Blender 4.2+ / MIT 协议，是 2026 年 10 月 GitHub Trending 上的 MCP Blender 集成样板工程。

核心能力

1. 场景上下文感知：在 AI 给出任何建议之前，先调用 Blender 接口读取当前场景结构、对象列表、材质细节，再让模型基于真实状态回答。
2. 可视化 Chat 工作区：除聊天外，还集成场景对象列表、视口快照、审批按钮、任务进度面板，让 AI 的每一步动作都能被审查。
3. 21 个 Blender 操作工具：对象创建、修改、相机控制、捕捉截图、检索资产、查询 API、导出场景等一应俱全。
4. 多模型 + 自托管支持：支持 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、Ollama 以及自定义 API 端点；可加载模型目录并按需切换。
5. 单助理与团队双模式：单一模型用于快速修改；Manager / Workers / Reviewers 团队模式用于复杂任务分工和验收闭环。
6. 多语言界面：英语、德语、法语、西班牙语、中文五种 UI 切换，方便国际化团队。
7. MCP 服务可独立接入：除 Studio 工作区外，Addon 自带 MCP 服务，允许外部支持 Streamable HTTP 的客户端（如 OpenCode、Claude Desktop）调用 Blender 工具集。

安装配置

1. 从 GitHub Releases 下载 mcp-for-blender-pro.zip
2. 在 Blender 中进入 Edit → Preferences → Get Extensions → Install from Disk 选择该 ZIP
3. 启用 mcp-for-blender-pro，然后在 3D 视口 N 面板里点 MCP Pro 标签
4. 配置 Provider 与模型（OpenAI / Claude / Gemini / Ollama / 自定义 API 均可）
5. 在 Blender 内直接发消息，或点 Open Studio Window 启用可视化工作区

要求：Blender 4.2+，Windows x64；保持 Blender 窗口打开以便 Studio 与 MCP 客户端并行工作。

使用步骤

1. 安装并启用 addon → 在 MCP Pro 面板里填入 API Key 与模型名。
2. 直接向 Studio 发送创意简报，例如："为这个场景做一个产品展示布局：基座 + 相机 + 三盏灯，基座用哑光蓝材质"。
3. Studio 调用 21 个 Blender 工具逐步执行，并在任务板上展示每一步的指令与产出。
4. 必要时升级到 Team 模式：Manager 拆任务 / Workers 各执行 / Reviewer 验收，2 次失败自动停。
5. 也可以让外部 OpenCode / Claude Desktop 直接通过 MCP 协议调用 Blender 工具集（已鉴权）。
6. 所有改动保留在原 Blender 场景，便于美术师在原工作流里继续修改。

适用场景

• 产品视觉 / 电商 3D：批量生成符合品牌规范的 3D 场景、材质、灯光预设。
• 技术美术自动化：把"做一面墙、改 PBR、烘焙法线、写导出脚本"等重复工作交给 AI。
• 教学 / 引导式 Blender 学习：边对话边操作 Blender 的实时辅导体验。
• 3D 资产批量质检：用 AI 批量检查场景中的命名、命名空间、几何问题。
• AI × Blender 插件开发：作为"MCP + 复杂 DCC"集成的参考实现，复用到 Houdini / Maya / Cinema 4D。

适用人群

• 想要在 Blender 中加速创意落地的 3D 美术 / TA
• 已有 MCP 客户端（OpenCode / Claude Desktop 等）并希望 DCC 工具被代理调用的开发者
• 研究 AI × Creative Tools 协作模式的产品 / 工程团队
• 多语言团队的 Blender 培训师

工作原理

Addon 把 Blender 的 bpy 操作封装成 21 个 MCP tool + Studio UI 中的对话组件；每次 AI 调用都先 fetch 场景状态、再决定下一步动作，确保模型能基于真实场景做事而不是凭幻觉。Studio 工作区本身是一个独立窗口（Web 技术栈），通过 WebSocket 与 Blender addon 双向通信。

官方链接

• GitHub：https://github.com/LiCinCan/blender-ai-mcp-addon
• Release 下载：https://github.com/LiCinCan/blender-ai-mcp-addon/releases/latest
• 快速上手：docs/QUICKSTART.md
• 连接与代理：docs/CONNECTIONS.md