第9章 插件与 MCP(进阶):把外部系统接进来

第 9 节 / 共 13 节 课程:DeepSeek Harness 实战课

进阶章节:第一次阅读可以跳过。只用 DSH 自带工具也能完成大部分任务;需要接数据库、知识库、内部 API 时再回来看。

进阶章节。当 DSH 自带工具不够用时,才需要插件和 MCP。先判断“要不要接”,再判断“怎么接”。

本章共 5 节,另附练习,建议按顺序阅读:

插件

插件是 DSH 的扩展单元:增加工具、改变界面、接入新模型 provider、增加会话存储/通知/审批策略等。

dsh plugin --profile web add <package-name>

插件市场索引:https://deepseek-harness.github.io/deepseek-harness/guide/plugin-market

安装第三方插件前至少确认:作者与仓库是否可信;请求了哪些权限;是否读取/上传你的文件;是否有维护记录。

MCP

MCP 是让 Agent 连接外部工具/数据源的协议。DSH 支持 stdio(本地子进程)和 streamable-http(远程服务),工具以 mcp__<serverName>__<tool> 的形式出现。

通用配置片段(写入 $DSH_HOME/profiles/web/cordis.patch.yml 或通过 --patch 引入):

- insert:
    - id: memory-my-server
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: my-memory
        transport: stdio
        command: my-memory-mcp
        args: []
        env: {}
        cwd: !!js process.cwd()

远程服务用:

        transport: streamable-http
        url: https://example.com/mcp
        headers:
          Authorization: Bearer <YOUR_TOKEN>

记忆 MCP

DSH 默认不带长期记忆。官方给了三份参考配置:Memorix、MCP Reference Memory、Engram。以 Memorix 为例:

npm install --global memorix@1.3.0
dsh web --patch "$PWD/apps/cli/config/examples/mcp-memory/memorix.cordis.yml"

注意:DSH 只负责发现工具,不负责安装/初始化上游;记忆服务有自己的数据目录、模型/embedding 配置;不要把“记忆”当成“事实”,它也可能过时/错误。

安全边界

接之前问自己:它能不能读我的数据库?能不能写?能不能发消息/下单/转账?日志里会不会留下敏感数据?出问题怎么断?原则:最小权限、可撤销、可审计。

什么时候不需要 MCP

只是读几个本地文件,文件工具足够;只是查网页,搜索/抓取足够;只是跑脚本,命令工具足够。不要为了架构感引入一堆连接器,每多一个连接器就多一个故障点和攻击面。

本章练习

列出一个希望接入的外部系统;判断它是插件、MCP,还是根本不需要;画出 Agent → 连接器 → 系统的数据流,标出权限与敏感数据;如果接,写出最小权限方案。