AB
AiBoss
project

blender-ai-copilot-bridge - 为 Blender 提供带鉴权的 MCP 场景工具桥接

blender-ai-copilot-bridge 是一个以 Blender 扩展形式运行的 MCP 桥接项目,据项目自述,它把 27 个受监督的场景工具通过本地带 Bearer 令牌鉴权的 Streamable HTTP 端点暴露给 OpenCode 及其他兼容客户端,让编码智能体能够读取场景结构、创建与编辑对象、截取视口并导出场景。

blender-ai-copilot-bridge 是一个以 Blender 扩展形式运行的 MCP(Model Context Protocol)桥接项目。按项目自述,它要解决的问题是:编码智能体可以读仓库、写代码、跑测试,但一旦任务变成「在 Blender 里把它做出来」就断了线。这个项目在 Blender 内部发布一个本地、带鉴权的 Streamable HTTP 端点,把一组受监督的场景工具暴露给外部客户端,让智能体用结构化工具调用代替截屏和手工复制场景数据。它适合已经在用 MCP 客户端(例如 OpenCode)做开发、又希望把 3D 场景操作纳入同一条工具链的用户,也适合想在 Blender 内直接使用聊天式工作流的建模与脚本用户。

维护者与状态

仓库由 benzgasfuncring197110 维护,采用 MIT 许可证。仓库创建于 2026-11-12,最后一次提交在 2026-11-15,最新正式版本为 v1.0.0,发布于 2026-11-15。截至 2026-11-20,仓库星标数为 492。从时间线看,这是一个创建后数天内即发布首个正式版本的年轻项目,版本号虽为 1.0.0,但公开历史很短,采用前建议先在自己的场景中验证工作流。

主要能力

以下能力均来自项目 README 的自述,未经独立验证:

  • 受监督的工具集:向任何兼容的 MCP 客户端暴露 27 个场景工具,覆盖检查、创建、编辑、截图、脚本执行与导出等环节。
  • 逐请求鉴权:每个请求都需携带生成的 Bearer 令牌,令牌保存在客户端的密钥存储或环境变量中。
  • OpenCode 预配置启动:随附的 Portable 启动器会在启动时自动完成 Blender 连接配置,用户只需登录服务商并选择模型。
  • 场景检查:以结构化上下文返回对象列表、层级结构与细节信息,供智能体作为真实上下文使用,而不是把视口截图粘进对话。
  • 视口截图:可捕获视口画面,供具备图像能力的智能体查看。
  • 控制权留在 Blender:审批、取消与具名撤销同样作用于外部调用,每次操作在 Blender 中可见且可撤销。
  • 结果导出:通过 export_scene 把完成的场景交给后续管线。
  • 内置 Studio 与智能体团队:同一套工具集在 Blender 内部驱动可视化聊天工作区,并可选启用 manager–worker–reviewer 式的多智能体链。

据项目说明,服务端默认监听本地地址 http://127.0.0.1:9876/mcp,端口可在扩展偏好设置中调整;配置项还包括服务商(OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zen、Ollama 或自定义 API)、模型、工作流模式(单助手或团队链)、界面语言(英语、德语、法语、西班牙语、中文)以及需要密钥的素材服务。

使用入口

项目仓库地址:blender-ai-copilot-bridge。

据 README 的快速开始,安装流程为:从 Releases 下载扩展 ZIP,在 Blender 中打开 Edit → Preferences → Get Extensions → 菜单 → Install from Disk,选择该 ZIP 并启用扩展,然后在 3D Viewport → N → MCP Pro 面板中选择服务商、填写连接信息并选择模型,即可在 Blender 内发送消息或点击 Open Studio Window。若使用外部客户端,则需先在扩展偏好设置中启用 MCP 服务器,保持 Blender 开启,再把端点地址与访问令牌配置到客户端中;令牌应像密码一样对待。README 强调该端点仅限本地,令牌对每次调用进行把关。

许可与限制

许可证为 MIT。使用边界方面,据项目自述:端点默认只在本机回环地址上监听,不对外网暴露;外部客户端的审批策略由客户端自身管理,Blender 侧仅保证操作可见与可撤销;项目文档中给出的平台关键词包含 Windows,但 README 未系统列出完整的系统与 Blender 版本要求,部署前应自行确认兼容性。此外,项目自述中提到的模型服务商、素材服务密钥等均需用户自备,项目本身不提供这些凭据。