Audite les serveurs Model Context Protocol par rapport à l'OWASP MCP Top 10 pour identifier les vulnérabilités de sécurité et attribuer des notes de sécurité.
Aussi connu sous CodingSelim/mcp-scan, owasp-mcp-scan
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.2.1
- Dernier commit
- 10 oct. 2026
- Licence
- MIT
Qu'est-ce que scan MCP ?
scan est un serveur MCP. Audite les serveurs Model Context Protocol par rapport à l'OWASP MCP Top 10 pour identifier les vulnérabilités de sécurité et attribuer des notes de sécurité.
Résumé généré à partir du README du projet
À propos du MCP server scan
L'audit des serveurs Model Context Protocol pour détecter les vulnérabilités de sécurité est la fonction principale de mcp-scan. Cet outil évalue les serveurs en direct par rapport à l'OWASP MCP Top 10 afin d'identifier des risques tels que l'injection de commandes, le path traversal et l'exposition de secrets. Il attribue une note de sécurité de A à F en fonction de ses résultats, aidant ainsi les développeurs à vérifier la sûreté d'un serveur avant de l'intégrer dans leurs workflows.
Les utilisateurs peuvent exécuter le scanner via une interface CLI en utilisant npx, en ciblant des serveurs locaux via stdio ou des points de terminaison HTTP distants. Il est conçu pour être passif et en lecture seule, ce qui signifie qu'il analyse les capacités annoncées sans jamais invoquer d'outils ni envoyer d'exploits, ce qui le rend sûr pour les environnements de production. Le scanner fournit des résultats aux formats console, JSON ou SARIF pour une intégration dans les pipelines CI/CD.
Au-delà des vérifications d'outils individuels, le scanner utilise une analyse spécialisée du toxic-flow pour détecter la trifecta mortelle consistant à lire des données privées, ingérer du contenu non fiable et exfiltrer des informations. Il peut également être installé en tant que MCP server, permettant à des clients IA comme Claude Desktop, Cursor ou Windsurf d'effectuer des audits de sécurité à la demande via l'outil scan_mcp_server.
Ce que vous pouvez faire avec
- 1Auditer un serveur localUn développeur peut lancer un contrôle de sécurité sur un serveur MCP local avec accès au système de fichiers avant de le connecter à un agent.
- 2Automatiser la sécurité dans la CI/CDLes équipes peuvent verrouiller leurs pipelines de déploiement en échouant les builds si un serveur reçoit une note de sécurité à haut risque.
- 3Détecter l'exfiltration de données complexeLes chercheurs en sécurité peuvent identifier les serveurs qui combinent des capacités de lecture de données et d'exfiltration grâce à la vérification toxic-flow.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer scan MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller scan MCP dans Claude Code
$ claude mcp add mcp-scan -- npx -y owasp-mcp-scanInstaller scan MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Installer scan MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mcp-scan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Installer scan MCP dans VS Code CLI
$ code --add-mcp '{"name":"mcp-scan","type":"stdio","command":"npx","args":["-y","owasp-mcp-scan"]}'Installer scan MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Installer scan MCP dans Codex
$ codex mcp add mcp-scan -- npx -y owasp-mcp-scanInstaller scan MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-scan] command = "npx" args = ["-y", "owasp-mcp-scan"]
Installer scan MCP dans Gemini CLI
$ gemini mcp add -s user mcp-scan npx -- -y owasp-mcp-scanInstaller scan MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblecodingselim/mcp-scan is public and reachablegithub.com/codingselim/mcp-scan ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-10github.com/codingselim/mcp-scan ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from owasp-mcp-scanRéussi
- Aucun avis critique dans le package ou ses dépendances100 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHub🛡️ mcp-scan
Passive security scanner for Model Context Protocol servers. Point it at any running MCP server; it audits the live server against the OWASP MCP Top 10 and grades it A–F. Read-only, so it is safe to run against production.
npx owasp-mcp-scan --stdio "npx -y @modelcontextprotocol/server-filesystem /tmp"
I ran it against the 12 most-installed MCP servers. 9 of them failed. No install, no config, no exploiting anything.
Why
MCP tool descriptions are fed straight into your model's context, and most public servers were never security-reviewed. A bad one can hide instructions in a description, expose a raw-shell tool, or leak a key; and your agent acts on it. Endor Labs found 82% of servers prone to path traversal, 34% to command injection.
mcp-scan is the gut-check before you wire a server in. It's passive: it reads advertised capabilities and analyzes them statically, never invoking tools, so it's safe against production servers.
How it works
- Connects to the server over stdio or Streamable HTTP and enumerates every advertised tool, prompt, and resource.
- Runs 12 static checks across that surface: secrets, injection, SSRF, path traversal, tool poisoning, excessive scope, and more.
toxic-flowreasons across the whole toolset for the lethal trifecta (reads private data + ingests untrusted content + can exfiltrate), the shape single-tool scanners miss.- Scores 0-100 and grades A-F (any critical forces F). Emits console, JSON, or SARIF.
It never calls a tool, never fuzzes, and never sends an exploit. The worst it does is read what the server already tells everyone.
Real findings on real servers
12 popular npm servers, actual output (snapshot 2026-07-11, full benchmark):
| Server | Tools | Grade | 🔴 | 🟠 | 🟡 | Notable |
|---|---|---|---|---|---|---|
firecrawl-mcp |
26 | F | 2 | 11 | 1 | lethal trifecta (MCP10) + code exec (MCP05) |
@modelcontextprotocol/server-filesystem |
14 | F | 0 | 1 | 11 | unconstrained path params (MCP01) |
@modelcontextprotocol/server-puppeteer |
7 | F | 1 | 2 | 0 | script param executes JS (MCP05) |
tavily-mcp |
5 | F | 0 | 3 | 1 | untrusted-input + exfiltration (MCP10) |
@modelcontextprotocol/server-memory |
9 | F | 0 | 3 | 0 | delete_* tools, no confirmation (MCP02) |
@modelcontextprotocol/server-github |
26 | D | 0 | 0 | 2 | state-changing tools (MCP02) |
@modelcontextprotocol/server-slack |
8 | C | 0 | 1 | 0 | reads + posts = data + exfil (MCP10) |
@modelcontextprotocol/server-everything |
13 | A | 0 | 0 | 0 | clean ✓ |
@kazuph/mcp-fetch |
1 | A | 0 | 0 | 0 | clean ✓ |
9 of 12 flagged, 3 clean, every row audited finding-by-finding, false positives stripped rather than padded. Reproduce any row yourself:
npx owasp-mcp-scan --stdio "npx -y firecrawl-mcp" # F: lethal trifecta + code exec
npx owasp-mcp-scan --stdio "npx -y @modelcontextprotocol/server-everything" # A: clean
Use it
CLI
npx owasp-mcp-scan --stdio "<command>" # local stdio server
npx owasp-mcp-scan --url https://host/mcp --header "Authorization: Bearer $TOKEN"
npx owasp-mcp-scan --config ~/.cursor/mcp.json --format sarif --output mcp.sarif
As an MCP server, let your agent scan servers on demand ("scan this MCP server before I add it"). Add to any client; this mcpServers shape works in Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, and Gemini CLI:
{ "mcpServers": { "mcp-scan": { "command": "npx", "args": ["-y", "owasp-mcp-scan", "--serve"] } } }
OpenAI Codex (~/.codex/config.toml):
[mcp_servers.mcp-scan]
command = "npx"
args = ["-y", "owasp-mcp-scan", "--serve"]
Exposes two tools: scan_mcp_server (audit a stdio/HTTP target) and list_checks.
Claude Code plugin
/plugin marketplace add CodingSelim/mcp-scan
/plugin install mcp-scan@mcp-scan
Also on the official MCP registry as io.github.CodingSelim/mcp-scan. Publishing steps: PUBLISHING.md.
What it checks
Full OWASP MCP Top 10 (2025) coverage, 12 checks:
| Check | OWASP | Catches |
|---|---|---|
secret-exposure |
MCP01 | AWS / OpenAI / Anthropic / GitHub / GitLab / Stripe / SendGrid / npm / HF / DB URIs / JWT / private keys in advertised text |
transport |
MCP01 | Plaintext http:// to a non-loopback host |
path-traversal |
MCP01 | file:///{path} templates and unconstrained path params |
excessive-scope |
MCP02 | Destructive tools (delete, drop, transfer) with no confirmation |
tool-poisoning |
MCP03 | Instruction overrides, hidden exfiltration directives, zero-width / Unicode-tag smuggling |
tool-shadowing |
MCP03 / MCP09 | Duplicate tool-name collisions and "call me first" precedence injection |
supply-chain |
MCP04 / MCP09 | Unpinned/placeholder versions and homoglyph server names |
command-injection |
MCP05 | Unconstrained command / shell / code params, raw SQL, advertised execution |
ssrf |
MCP05 | Arbitrary url / host params with no allowlist |
tool-poisoning (dynamic) |
MCP06 | Injection in resource contents and server instructions |
authn |
MCP07 | HTTP servers that complete an unauthenticated handshake |
telemetry |
MCP08 | High-impact tools with no audit trail (advisory, unscored) |
toxic-flow |
MCP10 | Lethal trifecta: one server that reads private data, ingests untrusted content, and can exfiltrate |
toxic-flow is the standout, it reasons across the whole toolset, catching the GitHub-MCP / email-agent injection shape that per-tool checks miss.
Output & CI
console (default) · json · sarif (GitHub Code Scanning). Exit code is non-zero at/above --fail-on (default high), so it gates CI:
- run: npx owasp-mcp-scan --url ${{ secrets.MCP_URL }} --format sarif --output mcp.sarif
- uses: github/codeql-action/upload-sarif@v3
with: { sarif_file: mcp.sarif }
Limitations (read these)
- Static analysis can't see runtime sandboxing, a server that safely confines paths still flags them. Verify against actual enforcement.
- Auth and transport checks apply to HTTP targets only.
- Heuristics favor recall, so triage findings in context. When a rule is tightened to kill a false positive, a test pins the intended behavior.
- Scanning a stdio target spawns that command, so run it only on servers you trust.
Develop
npm install && npm run build && npm test # 48 tests, incl. live end-to-end fixture scans
Checks are pure and isolated (src/checks/), reusing detectors in src/detectors/. See CONTRIBUTING.md.
References
OWASP MCP Top 10 · MCP Security Cheat Sheet · Vulnerable MCP Project · MCPTox
MIT © CodingSelim
Questions sur scan MCP
Comment ajouter scan MCP à Claude Code ?
Exécutez claude mcp add mcp-scan -- npx -y owasp-mcp-scan dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter scan MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Est-il sûr de l'exécuter sur des serveurs de production ?
Oui, il s'agit d'un scanner passif en lecture seule qui analyse les capacités annoncées sans invoquer d'outils.
Que vérifie le scanner ?
Il effectue 12 vérifications statiques, incluant l'exposition de secrets, l'injection, le SSRF, le path traversal et la trifecta « toxic-flow ».