Skip to main content

AI Supply Chain Security scanner — scan MCP servers, skill files, and agent configs for security risks

Project description

aiss-scan

AI Supply Chain Security scanner. Scan your local AI client configs and GitHub repos for security risks — no account required.

27% of 1,100+ public MCP repos carry CRITICAL findings.

Install

# Run immediately with uvx (no install needed):
uvx aiss-scan

# Or install permanently:
pip install aiss-scan

Usage

Scan your local AI configs (default)

Automatically finds and scans every MCP server configured in Claude Desktop, Cursor, Windsurf, and other AI clients on your machine.

uvx aiss-scan
AISS Local Config Scan
Configs found: 2
  ~/.claude/settings.json
  ~/.cursor/mcp.json

Servers scanned: 4
  1 BLOCK  — do not use
  1 REVIEW — investigate before use
  2 SAFE   — no findings

=== AISS Scan: @upstash/context7-mcp ===
Risk Score:  82/100  ✗ BLOCK

CRITICAL (1)
  [CHK-115] docs/troubleshooting.md:34
    confirmed · Credential access pattern in skill content

=== AISS Scan: @modelcontextprotocol/server-github ===
Risk Score:  0/100  ✓ SAFE

No findings.

Scan a specific config file

uvx aiss-scan --config ~/.cursor/mcp.json
uvx aiss-scan --config ~/Library/Application\ Support/Claude/claude_desktop_config.json

Scan a GitHub repo or npm package

uvx aiss-scan --repo https://github.com/Significant-Gravitas/AutoGPT
uvx aiss-scan --repo @upstash/context7-mcp
uvx aiss-scan --repo @azure/mcp

Output formats

# NDJSON — one JSON record per finding (Splunk / Elastic / SIEM)
uvx aiss-scan --json

# SARIF 2.1.0 — GitHub Security tab
uvx aiss-scan --sarif > results.sarif

# CI gate — exit code 1 on any CRITICAL finding
uvx aiss-scan --fail-on-critical

# Send results to aiss.dev for org dashboard
uvx aiss-scan --upload

GitHub Actions

- name: AISS MCP Security Scan
  run: uvx aiss-scan --sarif > aiss-results.sarif

- name: Upload to GitHub Security
  uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: aiss-results.sarif

For a pre-built Action: see .github/workflows/aiss-scan.yml

What gets checked

All checkers are deterministic, rule-based, and hand-written (no ML, no false-positive-prone heuristics).

Checker What it finds
CHK-115 Credential access patterns in skill files
CHK-116 Prompt injection in cursor rules
CHK-117 Credential access in cursor rules
CHK-118 Data exfiltration instructions in cursor rules
CHK-119 Kiro steering file injection
CHK-120 Kiro spec dangerous permissions + auto-execute
CHK-121 Copilot instructions injection
CHK-122 Credential access in Copilot instructions
CHK-123 Exfiltration in Copilot instructions
CHK-124 Rug pull — tool description changed since last scan
CHK-125 Excessive agency without scope constraint
+ 110 more CVEs, secrets, auth gaps, shadow tools, typosquats

Verdicts

Verdict Meaning
✓ SAFE No findings. Connect with confidence.
⚠ REVIEW Medium/High findings. Investigate before use.
✗ BLOCK CRITICAL findings or score ≥ 80. Do not connect.

Privacy

  • No data leaves your machine unless you pass --upload
  • No API keys required
  • Config files are read locally; only server identifiers (npm package names, GitHub URLs) are used for scanning
  • Environment variable values are never read or logged — only key names

Public registry

Check any MCP server before installing:

https://aiss.dev/registry/Significant-Gravitas/AutoGPT
https://aiss.dev/registry/modelcontextprotocol/server-git

1,100+ repos pre-scored. Updated continuously.

Real findings (from our corpus)

  • AutoGPT 184k★ — CHK-115: credential access in 3 SKILL.md files (AI confirmed)
  • garrytan/gstack 71k★--dangerously-skip-permissions + .env credential access
  • screenpipe/screenpipe 19k★ — Telegram data exfiltration in SKILL.md
  • modelcontextprotocol/server-git 85k★ — CVE-2025-68143 CVSS 8.8 path traversal
  • @upstash/context7-mcp 1M dl/wk — credentials in troubleshooting docs

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tanav-0.1.0.tar.gz (162.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tanav-0.1.0-py3-none-any.whl (196.4 kB view details)

Uploaded Python 3

File details

Details for the file tanav-0.1.0.tar.gz.

File metadata

  • Download URL: tanav-0.1.0.tar.gz
  • Upload date:
  • Size: 162.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for tanav-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a729a3bff3b6041989cc907e2edcd0a196b6cb94f762ef0469b068ec91920c50
MD5 f1cbbf28c86072bdfb80443b6d8580e5
BLAKE2b-256 2008b1dd6b09a3f14fd918f88506589ba87825aa9babe3a3bab557b501f3dd6f

See more details on using hashes here.

File details

Details for the file tanav-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: tanav-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 196.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for tanav-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4bf4bc82de69cf5ade10f0d84ba02621fcde8f935aa2d163287deb90ba0f6971
MD5 f5801000ce348876c6e3a39ca63c4e1e
BLAKE2b-256 d450ec908b0e94e4a235a296a677493ad3aec903e007d3d3062843fa7d80e728

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page