SuperAPI AI 工具集

dcc-mcp-blender-setup

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:该技能用于让代理或操作者准备一台机器,使任意 MCP 宿主(MCP host)能通过 dcc-mcp-blender 使用 Blender。它是操作者技能,不是 Blender 运行时技能,不应通过 Blender MCP 服务器加载;应从仓库检出目录运行,或把步骤复制到其他代理指令中。若用户要求参考仓库根目录 install.md 安装,先读该文件再按本技能执行。

主要能力:把 dcc-mcp-blender 及其 pip 依赖安装到目标 Blender 自带的 Python 环境;生成指向 Blender MCP 服务器的 MCP 宿主配置片段;写入兼容 Blender 5.x 的启动桥接脚本以自动启动内嵌服务器;提供实时冒烟提示词,验证代理能发现并调用 Blender 工具。

推荐用法:优先使用适配器生命周期命令。先解析确切的 Blender 可执行文件与目标 Python 解释器,再查看非变更计划:dcc-mcp-blender install --json --dry-run --dcc-path <absolute-blender-path> --python <absolute-python-path>。确认后执行同一计划并验证:dcc-mcp-blender install --json --yes --dcc-path <absolute-blender-path> --python <absolute-python-path>,随后 dcc-mcp-blender verify --json --dcc-path <absolute-blender-path> --python <absolute-python-path>。若安装后退出码为 40,说明宿主集成已写入但尚未证明存在活动 Blender 实例,应遵循返回的 next_steps,不要报告为可直接使用。

兼容旧流程:仍可用检出目录脚本 python skills/dcc-mcp-blender-setup/scripts/setup_dcc_mcp_blender.py,其可从 --blender-python/--python、环境变量或常见安装位置自动查找 Blender 自带 Python,安装当前检出并校验 import dcc_mcp_blender,写入启动脚本及 MCP JSON 与冒烟提示词至 .dcc-mcp/agent-setup/。改用 PyPI 源可加 --source pypi;权限受限时加 --user,启动 Blender 时须带 --python-use-system-env,否则 pip --user 安装的包会被忽略。

MCP 配置:Blender 实例使用系统分配端口,宿主应配置稳定本地网关 http://127.0.0.1:9765/mcp;多实例会自动注册各自端点,需要精确 URL 时用 dcc-mcp-cli list。编辑已有配置时保留无关服务器条目。

适用场景与限制:适用于为本机 Blender 环境准备 MCP 集成的操作者;不适用于通过 Blender MCP 服务器加载。Blender 4.2+ 扩展 ZIP 安装为替代路径,不可与 pip/启动脚本方案混用。资料未提供收费、价格或平台支持范围等信息。