用途
mcp-dependency-review 用于审查 MCP 配置中的包引用,判断这些引用是否可能在配置本身获批之后解析到不同的代码。这是一个静态审查工作流:只把配置当作文本/JSON 读取,不执行发现的 MCP 服务器命令。
主要能力
该技能对 npm/npx 风格包选择器、Python 包选择器和 Docker 镜像引用进行静态分类,输出 SAFE、HIGH、MEDIUM 或 REVIEW。例如:精确版本 package@1.2.3 为 SAFE;裸包名、@scope/package、@latest 或其他 npm 分发标签为 HIGH;^1.2.0、~1.2.0 等版本范围为 MEDIUM;本地路径、脚本或未知二进制为 REVIEW。Docker 镜像按 @sha256:DIGEST 固定为 SAFE,带标签或无标签且无摘要为 HIGH。Python 精确版本(package==1.2.3 或 uvx package@1.2.3)为 SAFE,无版本或 @latest 为 HIGH,版本范围或通配符为 MEDIUM,可编辑安装、直接 URL、VCS 引用为 REVIEW。
使用方式
- 定位仓库范围内的配置,先检查常见工作区路径,如 .mcp.json、.github/mcp.json、.cursor/mcp.json、.vscode/mcp.json、.windsurf/mcp.json、.kiro/settings/mcp.json 等,然后在请求的仓库/工作区内做有界发现。默认不检查主目录或机器级 MCP 配置,除非用户明确要求。
- 不执行地解析:读取 JSON 或配置文本,识别每个 MCP 服务器。对 npx、npm exec、bunx、pnpm dlx、yarn dlx 等包运行器调用,从命令行标志中分离出每个包选择器;包值标志也算包选择器。对 docker run 和 docker container run,将镜像与 Docker 选项及容器内命令分开。对 uvx 从 --from 分类包,对 pipx run 从 --spec 分类包。若调用、选项边界或选择器语法不受支持或含糊,报告 REVIEW,绝不省略配置的服务器、猜测所选包或执行命令来消除不确定性。
- 按静态分类表分类选择器。任何 npm 分发标签(不仅是 latest)都视为 HIGH。语法含糊时返回 REVIEW 而非猜测。
- 建议可复现的修复:对可变选择器,建议团队实际审查过的精确包版本。不要用今天的注册表最新版本代替固定版本;若已审查版本未知,应说明。注册表历史查询是单独的网络操作,仅在用户要求时执行。
- 生成有边界的报告,使用紧凑表格:Config、MCP server、Package/reference、Result、Why、Next step。
适用场景
在批准新的或变更的 MCP 配置之前;审查 .mcp.json、.github/mcp.json、.cursor/mcp.json、.vscode/mcp.json 或等效工作区配置时;向 CI 添加确定性 MCP 配置检查时;当 MCP 包引用使用 @latest、其他 npm 分发标签、裸包名或版本范围时;当团队想了解先前审查过的配置是否会静默解析到更新的包代码时。
限制
不运行 MCP 配置中的命令或参数;不启动 MCP 服务器来确认静态发现;不安装或解析引用的包来分类其版本选择器;不将凭据、标头、令牌或秘密值复制到报告中;不把依赖可变性单独描述为漏洞、入侵或恶意包。SAFE 仅适用于直接选择器或镜像摘要,不证明包完整性、来源或完整传递依赖可复现性,不是完整的安全结论。-y / --yes 仅作为上下文,它抑制交互确认,本身不是漏洞。审查默认限定在用户询问的仓库或工作区,除非明确要求更广范围。