audit-gap-auditor

@guardbee/mcp-audit-gap-auditor

🇬🇧 English | 🇹🇷 Türkçe | 🇨🇳 中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇧🇷 Português | 🇪🇸 Español | 🇩🇪 Deutsch

一个 MCP 服务，用于审计 MCP 服务源码是否存在 OWASP MCP08:2025 — 审计与遥测不足 问题。

security-proxy 已在网关处写入哈希链审计日志。此软件包要检查的是另一个问题：运行工具时，MCP 服务本身 是否会留下可用且不会泄露信息的记录？

默认情况下，遥测处于关闭状态。设置 GUARDBEE_TELEMETRY=1 后，它会发送服务、工具、成功状态、耗时以及文件路径等较短的参数值；较长的字符串以及 content、token 或 password 等字段会替换为占位符。请参阅 @guardbee/mcp-telemetry。

Claude ──► audit-gap-auditor ──► MCP server source
              │
              ├─ missing-telemetry  (tools registered, no audit/log/telemetry of invocations)
              ├─ unsafe-logging     (raw tool args or results written to logs)
              ├─ disabled-audit     (audit/telemetry hard-disabled in source)
              └─ silent-failure     (tool errors swallowed with an empty catch)

检查项

模式	严重级别	OWASP	含义
mcp_server_without_tool_audit	高	MCP08:2025	McpServer / FastMCP 注册了工具，但文件中从未提及审计/遥测
raw_tool_args_logged	严重	MCP08:2025	console/logger 记录了完整的 args/params/input 对象
raw_tool_result_logged	高	MCP08:2025	记录了完整的 result / toolResult
audit_disabled_in_code	高	MCP08:2025	audit: false、enableAudit: false、GUARDBEE_TELEMETRY=0 等
tool_error_swallowed_silently	中	MCP08:2025	工具处理程序中的 catch 为空或仅包含 return
audit_log_without_correlation_id	中	MCP08:2025	audit.log({…}) 中没有 sessionId / requestId / 类似字段

日志检查只会在看起来像 MCP 工具服务的文件中运行，因此会忽略其他位置普通的 console.log(args) 辅助代码。

快速开始

{
  "mcpServers": {
    "guardbee-audit-gap-auditor": {
      "command": "npx",
      "args": ["-y", "@guardbee/mcp-audit-gap-auditor"]
    }
  }
}

npx @guardbee/mcp-audit-gap-auditor scan ./src --fail-on=high --format=sarif > results.sarif

工具

工具	用途
scan_text	扫描源代码字符串
scan_file	扫描单个文件
scan_directory	递归扫描
list_patterns	列出 MCP08 检查项

guardbee.yml：

audit-gap-auditor:
  fail-on: high
  max-files: 5000
  exclude:
    - "fixtures/"

反馈

有疑问、想法或发现误报？请在 GitHub Discussions 中发起讨论，或提交问题。如果 GuardBee 对你有帮助，请在代码仓库点一个 ⭐，帮助更多人发现它。