AB
AiBoss
project

blender-ai-copilot-studio - 在 Blender 内用自然语言驱动场景操作的 AI 副驾驶与 MCP 服务器

blender-ai-copilot-studio 是一个以 Blender 扩展形式运行的 AI 副驾驶,同时对外提供本地 MCP 端点。据项目自述,它先读取场景再执行多步指令,内置 27 个场景工具,支持多智能体团队链、多家模型供应商与逐操作审批、命名撤销。本文整理其维护状态、能力、使用入口与许可限制。

blender-ai-copilot-studio 是一个以 Blender 扩展形式运行的 AI 副驾驶,同时对外提供一个本地 MCP(Model Context Protocol)端点。它要解决的问题很具体:在 Blender 里搭场景往往意味着大量菜单点击、鼠标移动和从论坛复制 bpy 代码片段,机械劳动挤占了真正用于构思的时间。据项目自述,这个副驾驶会先读取当前场景的对象、结构与材质,再把一段自然语言需求拆成有序的工具调用逐步执行,并配有审批、取消与命名撤销。它适合已经在用 Blender 做建模、产品可视化或场景搭建,希望把重复性布局交给自然语言处理的三维创作者,也适合想把 Blender 场景操作接入自有 agent 工作流、需要 MCP 接口的开发者。

维护者与状态

仓库由 credoksopho1984 维护,创建于 2026-11-12,最后一次提交在 2026-11-15。最新正式版本为 v1.0.0,发布于 2026-11-15。截至 2026-11-17,仓库星标数为 516。从时间线看,这是一个刚发布首个正式版本、仍在早期阶段的项目,提交历史很短,使用前应对版本迭代节奏有合理预期。

主要能力

以下能力均据项目 README 自述整理,未经独立验证:

  • 先读场景再动手:每次修改前,副驾驶会先检查场景中的对象、结构与材质,再决定操作步骤。
  • 27 个受监督的场景工具:据项目说明,这些工具覆盖基础几何体、灯光、摄像机、材质、父子关系与变换,可按顺序完成整套布局。
  • 多智能体团队链:管理者拆分任务、执行者动手、审查者批准或退回问题,任务板记录每一次尝试。
  • 多模型供应商:支持 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、本地 Ollama 以及自定义端点,并可保存多套连接配置。
  • 对外提供 MCP 服务:通过带鉴权的本地 Streamable HTTP 端点,把同一套工具集暴露给 OpenCode 及其他兼容 MCP 的客户端。
  • 对话中搜索与导入资产:可检索 Poly Haven、Sketchfab 与 Poly Pizza,经用户确认后导入。
  • 过程可控:逐操作审批、在当前步骤后取消、命名撤销步骤,界面提供英语、德语、法语、西班牙语与中文。

使用入口

项目仓库地址为 blender-ai-copilot-studio,安装包与版本发布在该仓库的 Releases 页面。

据 README 的快速开始说明,安装流程为:从 Releases 下载扩展压缩包;在 Blender 中打开 Edit → Preferences → Get Extensions → 菜单 → Install from Disk;选择该压缩包并启用扩展;随后在 3D Viewport 按 N 打开 MCP Pro 面板;选择模型供应商、填写连接信息并选定模型;最后在 Blender 内发送消息,或点击 Open Studio Window 打开 Studio 窗口。

若要从外部客户端调用,需在扩展偏好设置中启用 MCP 服务器,默认端点为 http://127.0.0.1:9876/mcp,端口可调整;客户端需携带启用时生成的访问令牌,以 Authorization: Bearer 请求头形式发送。自定义端点配置时,README 提醒应填写供应商的 base URL 而非完整的补全地址,并选择匹配的 API 协议(OpenAI Chat Completions、Anthropic Messages 或 Ollama)。

许可与限制

项目采用 MIT 许可证。

README 中写明的已知限制与前置条件包括:模型必须支持工具调用,否则会出现「模型有回复但场景毫无变化」的情况,此时应更换模型并重新加载模型列表;外部 MCP 客户端连不上时,需确认扩展中已启用 MCP 服务器、Blender 保持开启,并检查端点与令牌;自定义 API 的模型目录为空时,应改用 base URL、匹配正确的 API 协议,必要时手动填写模型 ID。凭据保存在本机 Blender 用户设置中,聊天历史仅在当前会话内保留,Studio 在本地运行并校验请求。资产搜索服务中需要密钥的供应商,需自行填写服务密钥。此外,项目自述中的能力描述与工具数量均来自维护者,实际表现需以本地使用为准。