Güvenlik açıklarını tespit etmek ve güvenlik derecelendirmesi atamak için Model Context Protocol sunucularını OWASP MCP Top 10 listesine göre denetler.
Ayrıca bilinen adı CodingSelim/mcp-scan, owasp-mcp-scan
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.2.1
- Son commit
- 10 Eki 2026
- Lisans
- MIT
scan MCP nedir?
scan bir MCP sunucusudur. Güvenlik açıklarını tespit etmek ve güvenlik derecelendirmesi atamak için Model Context Protocol sunucularını OWASP MCP Top 10 listesine göre denetler.
Özet, projenin README dosyasından oluşturuldu
scan MCP sunucusu hakkında
Model Context Protocol sunucularının güvenlik açıklarına karşı denetlenmesi, mcp-scan aracının temel işlevidir. Bu araç; komut enjeksiyonu, path traversal ve gizli veri ifşası gibi riskleri belirlemek için canlı sunucuları OWASP MCP Top 10 listesine göre değerlendirir. Bulgularına dayanarak A'dan F'ye kadar bir güvenlik derecesi atar ve geliştiricilerin bir sunucuyu iş akışlarına entegre etmeden önce güvenliğini doğrulamalarına yardımcı olur.
Kullanıcılar tarayıcıyı npx kullanarak bir komut satırı arayüzü (CLI) üzerinden çalıştırabilir; yerel stdio sunucularını veya uzak HTTP uç noktalarını hedefleyebilirler. Araç, pasif ve salt okunur olacak şekilde tasarlanmıştır; yani araçları asla çağırmadan veya exploit göndermeden ilan edilen yetenekleri analiz eder, bu da onu üretim ortamları için güvenli kılar. Tarayıcı, CI/CD süreçlerine entegrasyon için sonuçları konsol, JSON veya SARIF formatlarında sunar.
Bireysel araç kontrollerinin ötesinde tarayıcı, özel bir toxic-flow analizi kullanarak özel verileri okuma, güvenilmeyen içeriği işleme ve bilgi sızdırma (exfiltration) şeklindeki ölümcül üçlüyü tespit eder. Ayrıca kendisi bir MCP server olarak kurulabilir; böylece Claude Desktop, Cursor veya Windsurf gibi AI istemcilerinin scan_mcp_server aracını kullanarak talep üzerine güvenlik denetimi yapmasına olanak tanır.
Neler yapabilirsiniz
- 1Yerel bir sunucuyu denetlemeBir geliştirici, yerel bir dosya sistemi MCP server'ını bir ajana bağlamadan önce güvenlik kontrolü yapabilir.
- 2CI/CD süreçlerinde güvenliği otomatize etmeEkipler, bir sunucu yüksek riskli bir güvenlik derecesi alırsa derleme (build) süreçlerini durdurarak dağıtım hatlarını kontrol altında tutabilirler.
- 3Karmaşık veri sızdırma işlemlerini tespit etmeGüvenlik araştırmacıları, toxic-flow kontrolü sayesinde veri okuma ve veri sızdırma yeteneklerini birleştiren sunucuları tespit edebilirler.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
scan MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklescan MCP'yi Claude Code içine yükleyin
$ claude mcp add mcp-scan -- npx -y owasp-mcp-scanscan MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}scan MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp-scan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}scan MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp-scan","type":"stdio","command":"npx","args":["-y","owasp-mcp-scan"]}'scan MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}scan MCP'yi Codex içine yükleyin
$ codex mcp add mcp-scan -- npx -y owasp-mcp-scanscan MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp-scan] command = "npx" args = ["-y", "owasp-mcp-scan"]
scan MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user mcp-scan npx -- -y owasp-mcp-scanscan MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilircodingselim/mcp-scan is public and reachablegithub.com/codingselim/mcp-scan ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-10github.com/codingselim/mcp-scan ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from owasp-mcp-scanGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok100 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
🛡️ 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
scan MCP soruları
scan MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add mcp-scan -- npx -y owasp-mcp-scan komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
scan MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Üretim ortamındaki (production) sunucularda çalıştırılması güvenli mi?
Evet, araç, araçları (tools) çağırmadan ilan edilen yetenekleri analiz eden pasif ve salt okunur bir tarayıcıdır.
Tarayıcı neleri kontrol eder?
Gizli veri ifşası, injection, SSRF, path traversal ve 'toxic-flow' üçlüsü dahil olmak üzere 12 statik kontrol gerçekleştirir.