SuperAPI AI 工具集

blender-mcp-integration

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:帮助在 Blender 工作流中选择、配置并使用合适的 MCP 集成层,用于实时场景控制或确定性资产评估,例如把 Codex 或 Claude Code 接入 Blender。

主要能力与选择建议:优先使用 Blender 官方 Lab MCP(Blender 5.1+),支持实时场景检查、截图、文档查询、渲染、导航和 Python 执行。需要确定性批量检查、标准化几何证据和有界场景渲染时,使用 Blender Agent Studio 的 MCP;blender_render_scene 保留相机、灯光、体积和色彩管理并内联返回首张图像,inspectOnly 可在渲染前发现场景设置;内置 Poly Haven 搜索/下载工具可获取经验证的 CC0 纹理和 HDRI,无需额外插件或 API 密钥。仅当需要远程主机、Poly Haven、Sketchfab 或外部 3D 生成集成,且能接受额外安装、网络、凭据和遥测开销时,才考虑 ahujasid/blender-mcp。不要在同一主机/端口运行多个插件 socket 服务器;安装或替换 Blender 插件前先阅读 references/mcp-options.md。

浏览器集成:blender_prepare_mixamo_search 返回浏览器搜索 URL 和工作流,而非目录结果,需用宿主浏览器工具搜索、预览、下载,再用 blender_import_mixamo_animation 生成新的独立动画 .blend,Adobe 登录保留在浏览器中。blender_prepare_pixabay_sound_search 返回音效搜索 URL 和浏览器工作流,需用宿主浏览器工具查看、试听并下载,记录标题、作者、时长和来源页;Pixabay 官方 API 仅覆盖图像和视频,该工具不使用音频 API 或抓取目录,也不把音频导入 Blender 场景。

可选场景分析运行时:blender_compare_reference 生成相机匹配的参考/剪影/叠加板,直接通过 Blender 运行,无需 Rust,内联返回图像;经审核的黑底白字遮罩可选启用投影指标,仅照片只做视觉比较,不猜测相似度分数。blender_describe_scene、blender_quality_report 和 blender_compare_scenes 使用内置 Rust SceneIR 分析器,需在插件根目录用稳定 Rust 工具链运行 bun run setup:runtime,或设置 BAS_RUNTIME_EXECUTABLE 指向兼容的已构建二进制,更新后需重建;其余工具不依赖 Rust。

使用方式与限制:先用紧凑场景描述,再查询精确 objectId 及其后代;边界使用求值后的世界几何;语义角色仅来自编写的 bas_role 属性;质量约束需由任务说明提供,地面检查需要命名对象和 groundZ;AABB 关系是候选而非精确网格相交;保留返回的限制和必需的视觉问题,不产生数值美学评分。源级修复后,用 blender_compare_scenes 比较保留与重新生成的资产,将事实变化与显式声明的不变量失败分开,并配以相同视觉证据;可用 invariantObjects 排除被编辑组件。保持可复现性:即使使用实时 MCP 执行,也应把持久模型保存在 Python 源文件中;执行高风险任意代码前先保存新的 .blend;交互迭代使用官方 MCP 截图;最终干净进程检查和固定证据相机使用 $blender-agent-studio:blender-asset-validation;基准运行中记录使用了哪些 MCP 工具。评估 MCP 价值时,对比插件技能在 MCP 工具不可用与启用候选 MCP 两种情况,保持任务、模型、努力、时间预算和评估器一致,统计执行失败、恢复轮次、时间和最终资产质量,仅当能改善结果或显著降低可靠完成成本时才保留 MCP 依赖。