用途:对 MCP 服务器执行标准化、可复现的审计,依据版本化最佳实践目录(含瑞士、数据合规、身份及规范迁移层,120 项检查、十二个类别、两个规范基线),目标是在 30 个以上服务器组合中复用同一方法,避免每次重新解读 PDF。
主要能力:六步审计流程(环境准备、加载配置、适用性过滤、证据收集、结果聚合、报告生成);通过 applies_when 按配置过滤检查;证据优先于推测,严重性分级(critical 阻止生产);支持跨平台(Windows UTF-8 与路径处理);提供工具脚本完成初始化、目录解析、适用性评估、结果聚合、报告生成、发布建议与跟踪同步。
使用方式:先设置 PYTHONUTF8=1,使用 tools/ 下的脚本而非内联 heredoc,例如 python tools/audit_init.py init <server> --base-dir audits/ --catalog-dir checks/ --target-repo <repo> 初始化运行;用 python tools/validate_profile.py 校验配置;用 python tools/eval_applicability.py catalog profile.yaml 评估适用性;用 python tools/aggregate_results.py aggregate results.json --checks-dir checks/ --out summary.json 聚合结果;用 python tools/build_report.py <audit_dir> 生成报告。审计需在 Notion MCP Audit Tracker 中填写必填字段(传输方式、SDK 语言、认证模型、数据类别、写权限、部署、MCP 规范版本、仓库 URL),缺失则停止审计。
适用场景:多服务器组合的批量审计、规范迁移期间的双基线审计、需要可复现证据链的合规审计。
限制:MCP 规范版本为必填且无默认值;配置不完整会导致适用性计算错误;内联 heredoc 在 Windows Git Bash 下不可靠;代理写入 PR/Issue 时尖括号占位符可能被丢弃,需改用花括号并回读验证;目标仓库 SHA 需记录并在结束时复核,否则报告可能混合不同修订。部分细节(如具体收费、平台支持范围)暂未提供。