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 整合