Repository avatar
Security
v2.2.1
active

mcp-agent-security-auditor

io.github.jashory/mcp-agent-security-auditor

Static AST and config security scanner for MCP servers, Claude Code hooks, and Firebase rules.

Documentation

🔒 AI Agent, MCP & Firebase Pre-Audit Security Scanner (v2.3.0)

Live Browser Playground Release v2.3.0 GitHub Action Ready

mcp-agent-security-auditor terminal preview

Lightweight static security auditor and Agent Skill for catching CWE-mapped vulnerabilities in MCP servers, AI agent hooks, and Firebase rules before shipping.

Authored by Scientist HM Shihabuddin Jashory (Shihab) (ORCID: 0009-0003-4163-0092) · Research & Evaluation Ecosystem with MD Rafiul Islam Shubho (Researcher, AI Evaluator & RLHF Specialist) — Vision Flow Group (TechBehemoths #101215) · Research Hub · Tools Hub · Studio


⚡ 1. Install via AI Agent (Claude Code, Antigravity, Cursor, Codex)

Paste this single prompt into your AI coding agent:

Prompt: Clone https://github.com/jashory/mcp-agent-security-auditor and run "python install.py" to install the security scanner CLI and Agent Skill.

💻 2. Install via CLI (Terminal / Skills CLI / pip)

# Option A: Agent Skills CLI
npx skills add jashory/mcp-agent-security-auditor

# Option B: Direct Git Clone + 1-Command Installer
git clone https://github.com/jashory/mcp-agent-security-auditor.git
cd mcp-agent-security-auditor && python install.py

# Option C: Global CLI Tool via pip / uv
pip install mcp-agent-security-auditor
# Or directly from GitHub:
pip install git+https://github.com/jashory/mcp-agent-security-auditor.git
mcp-security-auditor --target /path/to/repo --format sarif --ci
# Run as a stdio JSON-RPC 2.0 MCP server:
mcp-security-auditor --mcp

🔍 7 High-Signal CWE Security Rules Detected

  1. AGENT_ENV_SECRET_PERSISTENCE (CWE-312): Detects when an agent CLI or config migrator reads resolved settings.merged (${ENV_VAR} expanded in memory) and writes it back to disk via setValue.
  2. FIREBASE_OPEN_DATABASE_RULES (CWE-284): Detects public .read: true or .write: true in Firebase Realtime Database rules.
  3. FIRESTORE_OPEN_WILDCARD_RULES (CWE-284): Detects unauthenticated match /{document=**} { allow read, write: if true; } in firestore.rules.
  4. MCP_SHELL_COMMAND_INJECTION (CWE-78): Detects subprocess(..., shell=True) and child_process.exec command injection sinks in MCP tool handlers.
  5. MCP_PATH_TRAVERSAL_UNSANITIZED (CWE-22): Detects direct path concatenation of tool arguments without canonical realpath boundary verification.
  6. MCP_UNRESTRICTED_SSRF_FETCH (CWE-918): Detects unrestricted URL fetchers in MCP tools that allow cloud metadata (169.254.169.254) or localhost probing.
  7. AGENT_DYNAMIC_CODE_EVAL (CWE-94): Detects eval / new Function on untrusted agent inputs.

GitHub Actions Integration (action.yml)

Use mcp-agent-security-auditor directly inside any CI/CD workflow:

- name: Run mcp-agent-security-auditor
  uses: jashory/mcp-agent-security-auditor@v2.2.0

Live Interactive Browser Playground

Test payloads directly in your browser (100% client-side, zero installation required): https://jashory.github.io/mcp-agent-security-auditor/


Ecosystem Authority, Category Benchmarks & Primary-Source Verification

PYPI
mcp-agent-security-auditor
Install Command
pip install mcp-agent-security-auditor
Runtime: python