MCP server, 소스 트리 및 패키지를 스캔하여 보안 취약점, 프로토콜 준수 여부 및 커버리지 격차를 확인합니다.
다른 이름 devlab-group/mcp-scanner
- 스타
- 35
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- Apache-2.0
scanner MCP란?
scanner은(는) MCP server입니다. MCP server, 소스 트리 및 패키지를 스캔하여 보안 취약점, 프로토콜 준수 여부 및 커버리지 격차를 확인합니다.
프로젝트 README에서 생성된 요약
scanner MCP server 정보
mcp-scanner의 주요 기능은 실행 중인 서버, 소스 트리 및 패키지를 감사하여 Model Context Protocol 구현을 보안화하는 것입니다. 개발자는 이 도구를 사용하여 MCP 배포 환경의 보안 취약점을 식별하고, 프로토콜 준수 여부를 검증하며, 커버리지 격차를 탐지할 수 있습니다. 원격 URL 스캔, 로컬 소스 트리 분석, 설치 스크립트를 실행하지 않는 npm 패키지 검사 등 다양한 스캔 방식을 지원합니다.
사용자는 원격 엔드포인트, 로컬 stdio 서버 또는 기존 클라이언트 설정을 대상으로 스캐너를 실행할 수 있습니다. 보안이 중요한 환경을 위해, 컨테이너 내에서 정적 링크된 ELF 실행 파일을 실행하는 런타임 stdio 모드를 제공합니다. 또한 프롬프트 인젝션 및 도구 포이즈닝(tool poisoning) 체크와 더불어 Go, Python, JavaScript, TypeScript, Java, Rust에 대한 source-to-sink 데이터 흐름 분석과 같은 심층 검사 기능을 제공합니다.
CI/CD 파이프라인 통합은 특정 종료 코드와 SARIF 형식의 결과 출력 기능을 통해 처리할 수 있습니다. 스캐너는 단순한 선언 읽기부터 거부 로직을 테스트하기 위한 잘못된 형식의 프로토콜 메시지 전송에 이르기까지, 상호작용을 제어하기 위해 다양한 프로브 레벨을 사용합니다. 시그니처 매칭을 위해 libyara가 필요하며 Go를 통해 설치할 수 있습니다.
활용 사례
- 1소스 코드 보안 검증로컬 저장소의 여러 파일에 대해 데이터 흐름 분석을 수행합니다.
- 2npm 패키지 안전 검사설치 스크립트를 실행하지 않고 게시된 패키지의 취약점을 스캔합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능devlab-group/mcp-scanner is public and reachablegithub.com/devlab-group/mcp-scanner ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-20github.com/devlab-group/mcp-scanner ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기mcp-scanner
A security scanner for Model Context Protocol servers. It scans live servers,
source trees, and packages, and reports both findings and coverage gaps.
SAFE requires every required analyzer to finish without a reported coverage
gap:
COMPLETED + SAFE required analysis ran, nothing blocking
COMPLETED + UNSAFE required analysis ran, something blocking
PARTIAL + UNKNOWN an analyzer could not finish
ERROR + UNKNOWN an analyzer failed
SKIPPED + UNKNOWN no analyzer produced usable analysis
Timeouts, crashes, unexplained files, and missing statuses downgrade the scan.
An analyzer error is never self-excusing; only an explicit best-effort policy
can exempt it. A known limitation is that any recorded file-skip reason accounts
for all skipped files, so some incomplete file scans can still be SAFE.
Install
go install github.com/devlab-group/mcp-scanner/cmd/mcp-scanner@latest
Signature matching requires libyara and a tagged build:
# Debian, Ubuntu
sudo apt install libyara-dev pkg-config
# Fedora, RHEL
sudo dnf install yara-devel pkgconf-pkg-config
# macOS
brew install yara pkg-config
make build-yara
See the YARA installation guide
for source builds. If /usr/local/lib is outside the linker path, run
sudo ldconfig or set LD_LIBRARY_PATH=/usr/local/lib. Builds without the
tag report YARA as unavailable.
Use
Scan a remote server:
mcp-scanner remote https://mcp.example.com/mcp
Scan a trusted stdio server as a child process:
mcp-scanner stdio -- npx -y @example/mcp-server
This runs the target on your machine with your privileges. For untrusted code,
use source or package, which do not execute it. runtime stdio runs only an
absolute, statically linked ELF executable in a container and needs a trusted
snapshot.
Scan the servers declared in your MCP client configuration:
mcp-scanner known-configs --run
--run scans remote entries. Stdio entries are skipped unless you also pass
--include-stdio, and any skipped stdio entry makes the command exit 3.
Scan a source tree, or a published package:
mcp-scanner source ./my-mcp-server
mcp-scanner package npm:@example/mcp-server@1.4.0
Gate a pipeline:
mcp-scanner remote https://mcp.example.com/mcp --format sarif --output results.sarif --fail-on high
Exit codes:
| Code | Meaning |
|---|---|
| 0 | scan completed, policy passed |
| 1 | bad flags or configuration |
| 2 | scan completed, policy failed |
| 3 | scan could not determine an answer |
| 4 | the scanner itself broke |
--fail-on defaults to high, so a pipeline that never sets it still stops
on a high or critical finding. Pass --fail-on none to report without
gating.
Treat exit code 3 as a pipeline failure. It means the scan did not finish.
What it checks
- MCP protocol conformance, capability declarations against actual behaviour, and how the server handles malformed input
- Authentication, token validation and session binding
- Prompt injection, tool poisoning, hidden Unicode and credential harvesting in the text a server hands a model
- Source-to-sink dataflow across files, in Go, Python, JavaScript, TypeScript, Java and Rust
- Mismatch between what a tool says it does and what its handler reaches
- Dependency vulnerabilities and package contents, without running install scripts
- Optional sandboxed confirmation of static findings
- Optional model-assisted review that supplements deterministic evidence
Scanning safely
By default, the scanner discovers capabilities without invoking real tools.
--active-probes none connect and read declarations
--active-probes safe also send malformed protocol messages a correct server must reject
--active-probes tool-calls permit tools named with --allow-tool-call
safe is the default. Its tools/call probes use an invalid name or a name
that does not exist, which a conforming server rejects before dispatch.
A loose server may dispatch such a request before validating the name. No
setting invokes arbitrary declared tools on a live server or sends intentionally
destructive requests. The runtime analyzer can invoke declared tools only inside
its sandbox.
Documentation
Development
make check # gofmt, vet, test, race, vulnerability scan, version check
make build
Three rules hold the design together: SAFE must mean the analysis ran,
every finding carries evidence, and every analyzer reports what it did not
look at.
Security
Report vulnerabilities privately. See SECURITY.md.
License
Apache License 2.0. See LICENSE. Binaries also include the third-party components listed in THIRD_PARTY_NOTICES.
scanner MCP 질문
source-to-sink 데이터 흐름 분석은 어떤 언어를 지원하나요?
이 스캐너는 Go, Python, JavaScript, TypeScript, Java, Rust 파일 간의 데이터 흐름 분석을 지원합니다.
실행 중인 서버를 스캔해도 안전한가요?
네, 기본적으로 스캐너는 'safe' 액티브 프로브를 사용합니다. 이는 규격에 맞는 서버라면 임의의 도구를 호출하지 않고 거부해야 하는 잘못된 형식의 프로토콜 메시지를 전송합니다.