前言¶
在 DeepSeek Harness(DSH)里做智能体或工作流时,如果希望模型能操作本机 Blender——改场景、跑脚本、配合 MCP 协议与编辑器交互——通常要自己拼 MCP 服务、Python 环境与 DSH 插件边界,还要考虑进程权限与依赖隔离。Blender 官方生态已有 Blender MCP Add-on / MCP Server 文档,DSH 侧则缺少一层「装好就能连当前 Blender 实例」的包装。
下面介绍社区插件 dsh-blender-mcp-bridge(维护者 XuezuoYS),它在 DSH 中包装并桥接 Blender MCP Add-on,让 DSH 上的模型可以对接用户正在使用的 Blender,并声明满足基础安全需要;插件在 SkillHub 目录中归类为工作流。本文事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-blender-mcp-bridge 是面向 DSH 的插件(当前包版本 0.1.3),目标兼容 DSH 最新 rc 线(package.json 中 engines.dsh 为 >=0.2.1-rc.2 <0.3.0)。一句话定位:在 DSH 与 Blender MCP Add-on 之间做桥接与封装,便于模型辅助 3D 创作,而不是 DeepSeek AI、Blender Foundation 或上游技能作者的官方产品。
核心功能¶
README 与包结构能核实的能力包括:
- 桥接 Blender MCP Add-on:把 DSH 侧能力接到用户工作流中的 Blender,依赖用户自行安装 Blender MCP Add-on。
- 运行环境自动准备:安装插件后,在用户打开目标 Blender 时,插件会识别当前 Blender 自带的 Python 运行库,并通过 pip 安装所需的 Python helper;运行环境与配置文件目录为
$DSH_HOME/dsh-blender-mcp-bridge。 - Web 侧设置入口:
package.json的dsh.client面向webprofile,并注入 DSH 客户端 locale 与 UI settings 模块;具体表单项见仓库内 设置页文档(安装完成后再按文档填写)。 - 随包 3D 辅助能力:项目 MIT 发布,并随包保留来自
create-3d-model技能库的内容(26 个 helper、6 个核心 references 等),许可与 NOTICE 见仓库 NOTICE 与docs/refer-create-3d-model.md。 - 诊断脚本:仓库提供
probe、probe:live等 npm scripts,用于预检与离线/在线探测(详见 README 与diagnostics/)。
安装与启用¶
DSH 支持图形界面安装插件;命令行安装请使用 README 原文命令(注意 --profile web):
dsh plugin --profile web add github:XuezuoYS/dsh-blender-mcp-bridge
安装前请确认 DSH 版本落在插件声明的 rc 范围内,且 Node 满足 >=22.0.0(见 package.json 的 engines)。
使用前和运行环境¶
按 README,使用前需要:
- 安装 Blender(>= 5.1)。
- 安装 Blender MCP Add-on(能力说明见 Blender MCP 文档)。
- 在 DSH 中安装本插件后,打开目标 Blender;插件会自动识别 Blender 的 Python 环境并安装 helper,配置落在
$DSH_HOME/dsh-blender-mcp-bridge。 - 在 DSH Web 设置中按 settings-ui.md 完成配置后再使用。
典型流程可以概括为:先满足 Blender 与 MCP Add-on 前置条件 → 用上述命令把插件装进 DSH(web profile)→ 启动 Blender 触发环境准备 → 在设置页补全桥接参数 → 在 DSH 对话或工作流中通过插件暴露的工具与当前 Blender 协作。仓库未在 README 中给出固定对话示例句;具体工具名与调用方式以安装后的 DSH 工具列表与 docs/ 为准。
适用场景与注意¶
适合谁:已在用 DSH(尤其是 web profile)做创作类工作流,本机常驻 Blender 5.1+,并愿意安装官方 MCP Add-on,希望模型通过 MCP 辅助建模、脚本与场景编辑的开发者。
权限与安全:DSH 插件以当前 DSH 进程权限运行;桥接会触及本机 Blender 与 $DSH_HOME 下的 helper 环境。安装前应阅读源码、MIT LICENSE 与第三方 NOTICE,确认可接受随包复制的 helper 与引用关系。
生态说明:DSH 社区目录(如 SkillHub 插件页)是独立站点,与 DeepSeek / 幻方无官方从属关系;插件星标等元数据以目录页为准(当前为 0)。
结尾¶
dsh-blender-mcp-bridge 把 DSH 与 Blender MCP Add-on 收成一条可配置的工作流路径:自动准备 $DSH_HOME/dsh-blender-mcp-bridge 下的 Python helper,并在 Web 侧提供设置入口。若你的场景是「DSH 模型 + 本机 Blender」,可按 README 命令安装,并对照设置文档完成桥接。