AB
AiBoss
project

Blender-AI-MCP-Suite - 把自然语言指令变成可审阅、可回退的 Blender 场景操作

Blender-AI-MCP-Suite 是运行在 Blender 内的 AI 助手与内置 MCP 服务器,据项目自述可把自然语言需求拆成有序步骤,逐步审批执行并保留命名撤销检查点,支持多智能体分工与多家模型接入。

Blender-AI-MCP-Suite 是一个以 Blender 扩展形式分发的 AI 助手,同时内置一个 Model Context Protocol(MCP)服务器。它要解决的问题很具体:三维场景搭建里大量工作是机械性的——摆道具、调材质、反复导出变体——而通用聊天窗口看不到你的场景,直接跑脚本又缺少审阅环节。据项目说明,这套工具让助手先读取场景中的物体、变换、材质与修改器,再把一句自然语言需求拆成有序步骤,逐步在对话中审批执行,每次改动前留下命名的撤销检查点。它适合已经在用 Blender、希望把重复性场景操作交给对话流程,但仍要保留逐步确认与回退能力的三维工作者。

维护者与状态

项目由 findavoulot1973 维护,仓库创建于 2026-11-12,最后一次提交在 2026-11-15。最新正式版本为 v1.0.0,发布于 2026-11-15。截至 2026-11-20,仓库星标数为 498。从时间线看,这是一个刚发布首个版本、迭代节奏很快的新项目,公开可查的历史提交窗口只有数天。

主要能力

以下能力均来自项目自述(README),未经本站实际运行验证:

  • 先检查再动手:助手在操作前读取场景中的物体、变换、材质与修改器,作为后续规划的上下文。
  • 对话式搭建与编辑:基础几何体、灯光、相机、父子关系、复制与材质,都以可审批的步骤形式落地。
  • 视觉校验:通过视口截图,让具备视觉能力的模型检查自己的产出。
  • 单助手或团队模式:可以只跑一个助手,也可以配置管理者、执行者与审阅者组成的团队,各自拥有独立的指令与模型。
  • 多模型接入:README 列出 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、本地 Ollama 以及自定义端点。
  • 素材检索与导入:在对话中搜索 Poly Haven、Sketchfab 与 Poly Pizza,导入前需确认。
  • 自动化与导出:bpy API 查询、节点描述、经校验的 Python 执行以及场景导出,均可通过命名撤销检查点回退。

项目自述其内部由三部分协作:AI Suite 侧边栏负责对话、场景大纲、视口快照、审批与任务板;连接管理器保存不同服务商、密钥与模型,并区分工作与个人用途;内置 MCP 服务器则提供一个带认证的本地 Streamable HTTP 端点,供外部客户端调用同一套工具。据 README,场景工具数量为 21 个以上。

使用入口

仓库地址:Blender-AI-MCP-Suite。

据项目说明,安装流程为:从 Releases 下载扩展 ZIP,在 Blender 中依次打开 Edit → Preferences → Get Extensions → 菜单 → Install from Disk,选择该 ZIP 并启用扩展,然后在 3D Viewport 中按 N 打开 MCP Pro 面板;接着选择服务商、填写连接信息并选定模型,即可在 Blender 内发送消息,或点击 Open Studio Window 打开 Studio 工作区。外部 MCP 客户端(README 以 OpenCode 为例)通过侧边栏显示的本地端点接入,使用期间需保持 Blender 开启。

许可与限制

项目采用 MIT 许可证。

据 README 的常见问题部分,已知边界包括:需要 Blender 4.2 或更高版本,且当前面向 Windows x64;下载的 ZIP 若被系统拦截,需在文件属性中解除锁定后重新安装;助手无响应或未改动场景时,应检查连接信息与密钥、确认所选模型支持工具调用,并在对话中批准待执行操作;团队任务被阻塞时只有一次纠正机会,第二次审阅失败会中止流程,需打开任务板查看结论并从上一个已批准步骤继续。凭据保存在本机用户设置中,聊天记录仅限当前会话。项目明确说明,Python 工具校验是一道防护栏,而非安全沙箱。