Audit Gap Auditor

io.github.GuardBee由 GitHub 账号 GuardBee 发布v0.4.1更新于 Nov 3, 2026

OWASP MCP08 audit/telemetry gaps: missing tool-call logs, raw args in logs, disabled audit

发布方自己的服务:audit.domains - Domain Valuation

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

审计 MCP 服务器源码中的 OWASP MCP08:2025 审计与遥测缺口,标记缺少工具调用日志、日志含原始参数、审计被禁用等问题。

可以做什么
  • 扫描源码字符串、单个文件或整个目录中的 MCP 服务器代码,查找审计与遥测缺口
  • 报告已注册工具却无审计记录、日志写入原始工具参数或结果、代码中硬性关闭审计、工具错误被静默吞掉、审计记录缺少会话或请求 ID 等问题
  • 列出该审计器执行的全部 OWASP MCP08 检查项及其严重级别与含义
  • 日志类检查只针对看起来像 MCP 工具服务器的文件,忽略无关的辅助代码
适用场景
适合在开发或评审 MCP 服务器时,快速静态检查工具调用是否留下可用且不泄露敏感信息的审计痕迹。适用于发布前审查或对源码目录做类似 CI 的检查,而非运行时监控。
运行要求
以本地 stdio 进程运行,通常通过 npx 从 npm 包启动,因此需要 Node.js 以及下载包所需的网络访问。未声明任何账号、API 密钥、环境变量或请求头。它会读取本机源码文件。
安装前请注意
遥测默认关闭;设置 GUARDBEE_TELEMETRY=1 后会把服务器、工具、成功与否、耗时以及文件路径等短参数值发送给厂商,较长字符串及 content、token、password 等字段会被替换为占位符。扫描会读取本地源码,其中可能含密钥。结果基于静态模式匹配,不能证明运行时行为。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Audit Gap Auditor,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@guardbee/mcp-audit-gap-auditor

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

[npm version] [npm downloads] [License: MIT]

An MCP server that audits MCP server source for OWASP MCP08:2025 — Lack of Audit and Telemetry.

security-proxy already writes a hash-chained audit log at the gateway. This package asks a different question: does the MCP server itself leave a usable, non-leaky trail when a tool runs?

Telemetry is off by default. With GUARDBEE_TELEMETRY=1 it sends the server, tool, success, duration and short parameter values such as a file path; longer strings and fields like content, token or password are replaced with a placeholder. See @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)

What it flags

PatternSeverityOWASPMeaning
mcp_server_without_tool_audithighMCP08:2025McpServer / FastMCP registers tools but the file never mentions audit/telemetry
raw_tool_args_loggedcriticalMCP08:2025console/logger logs the full args/params/input object
raw_tool_result_loggedhighMCP08:2025Full result / toolResult logged
audit_disabled_in_codehighMCP08:2025audit: false, enableAudit: false, GUARDBEE_TELEMETRY=0, …
tool_error_swallowed_silentlymediumMCP08:2025Empty / return-only catch around a tool handler
audit_log_without_correlation_idmediumMCP08:2025audit.log({…}) with no sessionId / requestId / similar

Logging checks only run in files that look like MCP tool servers, so ordinary console.log(args) helpers elsewhere are ignored.

Quick start

json
{  "mcpServers": {    "guardbee-audit-gap-auditor": {      "command": "npx",      "args": ["-y", "@guardbee/mcp-audit-gap-auditor"]    }  }}
bash
npx @guardbee/mcp-audit-gap-auditor scan ./src --fail-on=high --format=sarif > results.sarif

Tools

ToolPurpose
scan_textScan a source string
scan_fileScan one file
scan_directoryRecursive scan
list_patternsList MCP08 checks

guardbee.yml:

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

Feedback

Questions, ideas, or a false positive? Start a thread in GitHub Discussions or open an issue. If GuardBee is useful to you, a ⭐ on the repository helps others find it.

来源:packages/audit-gap-auditor/README.md,提交 bc5997d

工具

4

scan_text

Scan MCP server source for OWASP MCP08:2025 (Lack of Audit and Telemetry) gaps: tools registered with no audit trail, raw args/results logged, audit hard-disabled, silent catch blocks, audit events without a session/request id.

输入参数labelcontent必填

scan_file

Scan a single file for OWASP MCP08 audit/telemetry gaps

输入参数path必填

scan_directory

Recursively scan a directory of MCP server source for OWASP MCP08 audit/telemetry gaps

输入参数path必填excludeincludemaxFiles

list_patterns

List every OWASP MCP08 audit-gap check this auditor runs

无需输入参数。

版本历史

4
  1. v0.4.1最新Oct 30, 2026
  2. v0.3.2Oct 22, 2026
  3. v0.2.3Oct 13, 2026
  4. v0.2.2Oct 9, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Audit 集成