Skip to main content

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

Live Browser Playground Release v2.0.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 /path/to/repo --format markdown

🔍 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.0.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

Metadata

Release files for mcp-agent-security-auditor 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-agent-security-auditor 2.1.0
File Size Uploaded Provenance Actions
mcp_agent_security_auditor-2.1.0.tar.gz 8.2 kB Without provenance Details for mcp_agent_security_auditor-2.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-agent-security-auditor 2.1.0
File Interpreter ABI Platform Actions
mcp_agent_security_auditor-2.1.0-py3-none-any.whl Python 3 none any Details for mcp_agent_security_auditor-2.1.0-py3-none-any.whl

Total release size: 17.5 kB

Release files / mcp_agent_security_auditor-2.1.0.tar.gz

Download URL mcp_agent_security_auditor-2.1.0.tar.gz
Size 8.2 kB
Tags Source
SHA-256 checksum
How to use checksums
8d7d48447ea8bfe509f733b17fd2342978dd3ac8b7bc8b891cf6ec7adc599a50
BLAKE2b-256 checksum
How to use checksums
df29a0e21080058833259fadba35b4d7da4bf27a92349d4562008b54f349f31f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / mcp_agent_security_auditor-2.1.0-py3-none-any.whl

Download URL mcp_agent_security_auditor-2.1.0-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
05fc81fb10a07d6c85a412feb7828f3be61d0e4b2df5902d07c108dc4420384e
BLAKE2b-256 checksum
How to use checksums
b7e3b699705971f415999c82088ceba2f37ad470c6fc607473607088a6656c99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for mcp-agent-security-auditor 2.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page