Audit Gap Auditor
Static auditor for MCP server source against OWASP MCP08 logging and audit gaps
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- today
Similar MCP servers
About Audit Gap Auditor
Audit Gap Auditor is an MCP server for security. It runs locally on your machine and is started by your AI client.
Where GuardBee's gateway proxy writes a hash-chained audit log, this package turns the question around and asks whether an MCP server itself leaves a usable, non-leaky trail when a tool runs. It scans source code for four patterns: missing telemetry, unsafe logging, audit disabled in code, and tool errors swallowed by an empty catch.
The README lists six checks. Registering tools with McpServer or FastMCP without any audit mention is rated high, logging a full args or params object is critical, logging whole results is high, audit: false style switches are high, and empty catch blocks and audit rows with no session or request ID are medium. Logging checks only run in files that look like MCP tool servers, so ordinary helper logs are ignored.
Use it from an MCP client through scan_text, scan_file and scan_directory, or as a CLI that writes SARIF and fails on a chosen severity. A guardbee.yml file sets fail-on, max-files and excludes. Telemetry is off by default.
Install
Run in a terminal
claude mcp add audit-gap-auditor -- npx -y @guardbee/mcp-audit-gap-auditorAdd to claude_desktop_config.json
{
"mcpServers": {
"audit-gap-auditor": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-audit-gap-auditor"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"audit-gap-auditor": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-audit-gap-auditor"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"audit-gap-auditor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-audit-gap-auditor"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"audit-gap-auditor": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-audit-gap-auditor"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"audit-gap-auditor": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-audit-gap-auditor"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- scan_text
- Scans a source string
- scan_file
- Scans one file
- scan_directory
- Scans a directory recursively
- list_patterns
- Lists the MCP08 checks
What it does
- Six MCP08 checks
- Missing tool audit, raw args or results in logs, disabled audit, swallowed errors and missing correlation IDs.
- Severity ratings
- Each pattern is rated critical, high or medium.
- Scoped logging checks
- Only runs log checks on files that look like MCP tool servers.
- Four scan tools
- `scan_text`, `scan_file`, `scan_directory` and `list_patterns`.
- CI output
- CLI supports `--fail-on` and SARIF output.
- Config file
- `guardbee.yml` sets thresholds, file caps and excluded paths.
Good for
- Review an MCP server's source before publishing it
- Catch tool handlers that log raw arguments or secrets
- Fail a CI build when an MCP server has no audit trail
- Find tool errors that are silently swallowed
Audit Gap Auditor FAQ
What standard does it check?
OWASP MCP08:2025, lack of audit and telemetry.
What does it flag as critical?
Logging the full args, params or input object of a tool call.
How do I run it in CI?
`npx @guardbee/mcp-audit-gap-auditor scan ./src --fail-on=high --format=sarif`.
Is telemetry sent?
Telemetry is off by default and only enabled with `GUARDBEE_TELEMETRY=1`.
How do I add Audit Gap Auditor to Claude Code?
Run this command in your terminal: claude mcp add audit-gap-auditor -- npx -y @guardbee/mcp-audit-gap-auditor
What are the best alternatives to Audit Gap Auditor?
The closest alternatives to Audit Gap Auditor are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


