工具面漂移闸门 zhengqiuyang/dsh-mcp-test

dsh-mcp-test

为 DeepSeek Harness（dsh）提供工具面快照与漂移闸门。

模型能调用的一切都是供应链面：一方工具、插件工具、MCP 工具。这个插件把完整的可见工具注册表（名称 / 描述 / 参数，通过 ctx.tools.schemas() 获取）拍成快照，存下一份你提交进仓库的基线，再把注册表的每次变化与基线做 diff——这样升级插件或 MCP 服务器时，如果它悄悄新增、删除或改动了某个工具，会直接报错，而不是蒙混过关。信任路径上零 LLM 调用。

同族插件：dsh-read-guard（智能体读什么）· dsh-pr-gate（它们写什么）· dsh-attest（它们做了什么）· dsh-mcp-test（它们能调用什么）。

为什么是现在（核查于 2026-10-12）

dsh 供应链这条线上已经有七个静态扫描插件（在安装时审查包清单）——没有一个盯着活的工具面。dsh-plugin-observatory 在加载器层面审计插件兼容性，而不是模型可见的 schema 层面。升级时真正要紧的那个问题没人回答：「我的模型能调用的东西刚刚变了吗？」 schema-diff 方法论移植自 mcp-test 的升级闸门，只是把它应用到整个注册表，而不是单个 MCP 连接。

工作原理

boot / tools/change ──> snapshot ctx.tools.schemas()
──> baseline present? diff : establish baseline
──> drift: added / removed / changed(name.description|parameters)
──> warn (default) or rebaseline (explicit opt-in)

- 基线文件（.dsh-mcp-test/baseline.json，按名称排序，稳定 JSON）就是要你提交进仓库的——它就是契约。
- 参数 diff 不区分键的顺序（重排 schema 不算漂移；改动才算）。
- ignoreTools 用来排除你自己故意做成动态的工具。

v0.1 只交付快照 + 漂移这一支柱。行为探测支柱（针对运行中的 MCP 服务器做功能测试和注入测试，也就是 mcp-test 的招牌功能）在路线图上。

安装

dsh plugin --profile default add dsh-mcp-test

从 npm 安装——无需构建步骤，无需 allowBuilds 授权；从 git 安装同样是预构建好的（lib/ 随仓库一起发布）。

配置

- id: dsh-mcp-test
name: dsh-mcp-test
config:
baselinePath: .dsh-mcp-test/baseline.json
rebaselineOnDrift: false # true only when accepting an intended upgrade
ignoreTools: []

开发

npm install
npm test

路线图

- 探测支柱：针对运行中的 MCP 服务器做功能探测和注入探测（移植 mcp-test 的 runner）
- 按来源分别快照（一方工具、插件工具、MCP 工具各用独立基线）
- 漂移 → CI 桥接：把产出文件用作仓库级闸门产物

终止条件

如果 dsh 自己推出了一方工具面锁定，或者 observatory 那一类插件加上了 schema 级漂移闸门，这个插件就冻结在最后一个可用版本，并在这里附上复盘。