OWASP MCP Top 10을 기준으로 Model Context Protocol 서버를 감사하여 보안 취약점을 식별하고 안전 등급을 부여합니다.
다른 이름 CodingSelim/mcp-scan, owasp-mcp-scan
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.2.1
- 마지막 커밋
- 2026년 10월 10일
- 라이선스
- MIT
scan MCP란?
scan은(는) MCP server입니다. OWASP MCP Top 10을 기준으로 Model Context Protocol 서버를 감사하여 보안 취약점을 식별하고 안전 등급을 부여합니다.
프로젝트 README에서 생성된 요약
scan MCP server 정보
mcp-scan의 주요 기능은 Model Context Protocol 서버의 보안 취약점을 감사하는 것입니다. 이 도구는 실행 중인 서버를 OWASP MCP Top 10 기준으로 평가하여 커맨드 인젝션, 경로 탐색, 비밀 정보 노출과 같은 리스크를 식별합니다. 분석 결과에 따라 A부터 F까지 안전 등급을 부여하며, 개발자가 서버를 워크플로에 통합하기 전에 안전성을 검증할 수 있도록 지원합니다.
사용자는 npx를 이용한 CLI를 통해 스캐너를 실행할 수 있으며, 로컬 stdio 서버 또는 원격 HTTP 엔드포인트를 대상으로 지정할 수 있습니다. 이 도구는 수동적이고 읽기 전용으로 설계되었습니다. 즉, 도구를 호출하거나 익스플로잇을 전송하지 않고 공개된 기능만 분석하므로 운영 환경에서도 안전하게 사용할 수 있습니다. 스캔 결과는 콘솔, JSON 또는 SARIF 형식으로 제공되어 CI/CD 파이프라인에 통합하기 용이합니다.
개별 도구 점검 외에도, 스캐너는 특화된 toxic-flow 분석을 사용하여 개인 데이터 읽기, 신뢰할 수 없는 콘텐츠 수집, 정보 유출이 결합된 치명적인 3요소를 탐지합니다. 또한 이 도구 자체를 MCP server로 설치할 수 있어, Claude Desktop, Cursor, Windsurf와 같은 AI 클라이언트가 scan_mcp_server 도구를 사용하여 필요할 때마다 즉시 보안 감사를 수행할 수 있습니다.
활용 사례
- 1로컬 서버 감사개발자가 로컬 파일 시스템 MCP server를 에이전트에 연결하기 전에 보안 점검을 수행할 수 있습니다.
- 2CI/CD 보안 자동화서버가 높은 보안 위험 등급을 받을 경우 빌드를 실패하게 설정하여 배포 파이프라인을 제어할 수 있습니다.
- 3복잡한 데이터 유출 탐지보안 연구자가 toxic-flow 점검을 통해 데이터 읽기 기능과 유출 기능이 결합된 서버를 식별할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
scan MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 scan MCP 설치
$ claude mcp add mcp-scan -- npx -y owasp-mcp-scanCursor에 scan MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}VS Code에 scan MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-scan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}VS Code CLI에 scan MCP 설치
$ code --add-mcp '{"name":"mcp-scan","type":"stdio","command":"npx","args":["-y","owasp-mcp-scan"]}'Claude Desktop에 scan MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Codex에 scan MCP 설치
$ codex mcp add mcp-scan -- npx -y owasp-mcp-scanCodex config.toml에 scan MCP 설치
~/.codex/config.toml
[mcp_servers.mcp-scan] command = "npx" args = ["-y", "owasp-mcp-scan"]
Gemini CLI에 scan MCP 설치
$ gemini mcp add -s user mcp-scan npx -- -y owasp-mcp-scanGemini settings.json에 scan MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능codingselim/mcp-scan is public and reachablegithub.com/codingselim/mcp-scan ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-10github.com/codingselim/mcp-scan ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from owasp-mcp-scan통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음100 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
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
scan MCP 질문
scan MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add mcp-scan -- npx -y owasp-mcp-scan를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
scan MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
운영 서버에서 실행해도 안전한가요?
네, 도구를 호출하지 않고 공개된 기능만 분석하는 수동적(passive) 방식의 읽기 전용 스캐너입니다.
스캐너는 무엇을 점검하나요?
비밀 정보 노출, 인젝션, SSRF, 경로 탐색(path traversal) 및 'toxic-flow' 3요소를 포함하여 12가지 정적 점검을 수행합니다.