LLM에 데이터를 전송하기 전, PDF, 스크린샷, 스캔된 문서를 텍스트 레이어 및 OCR로 스캔하여 PII와 자격 증명을 탐지합니다.
다른 이름 GuardBee/guardbee-mcp, @guardbee/mcp-document-scanner
- 스타
- 2
- Tools
- 3
- 다운로드, 30일
- 3,086
- 최신 버전
- 0.4.1
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- MIT
document-scanner MCP란?
document-scanner은(는) MCP server입니다. LLM에 데이터를 전송하기 전, PDF, 스크린샷, 스캔된 문서를 텍스트 레이어 및 OCR로 스캔하여 PII와 자격 증명을 탐지합니다. 3개 도구를 제공합니다. 예: scan_document, scan_base64, list_detectors.
프로젝트 README에서 생성된 요약
document-scanner MCP server 정보
이 도구의 주요 기능은 민감한 정보가 대규모 언어 모델로 전송되는 것을 방지하는 것입니다. PDF, 스크린샷 및 다양한 이미지 형식을 스캔하여 AI 클라이언트에 도달하기 전에 개인 데이터와 자격 증명을 식별합니다. 텍스트 레이어를 분석하고 스캔된 페이지나 이미지에 OCR을 사용하여 IBAN, 여권 번호, 이메일 주소, 전화번호와 같은 특정 패턴을 탐지합니다.
개발자는 npx를 사용하여 로컬 MCP 설정에 이 MCP server를 통합하거나 npm을 통해 설치할 수 있습니다. tesseract.js를 통해 영어와 터키어를 지원하며, 렌더링에는 @napi-rs/canvas를 사용합니다. 시스템은 파일 이름이나 MIME 유형에 의존하지 않고 바이트에서 직접 파일 유형을 식별합니다. 표준 자격 증명 형식과 함께 TC Kimlik No 및 MERSİS와 같은 터키 식별자를 위한 전용 탐지기를 포함합니다. 사용자는 처리 부하를 관리하기 위해 25 MB 파일 크기 또는 문서당 최대 50페이지와 같은 제한을 구성할 수 있습니다.
활용 사례
- 1자동 문서 보안 감사파일 디렉토리에 대해 커맨드 라인 스캔을 실행하여 GitHub Code Scanning용 SARIF 보고서를 생성합니다.
- 2터키 특정 식별자 탐지스캔된 문서 내에서 VKN 또는 MERSİS 번호와 같은 민감한 터키 데이터를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
document-scanner MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 document-scanner MCP 설치
$ claude mcp add document-scanner -- npx -y @guardbee/mcp-document-scannerCursor에 document-scanner MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}VS Code에 document-scanner MCP 설치
.vscode/mcp.json
{
"servers": {
"document-scanner": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}VS Code CLI에 document-scanner MCP 설치
$ code --add-mcp '{"name":"document-scanner","type":"stdio","command":"npx","args":["-y","@guardbee/mcp-document-scanner"]}'Claude Desktop에 document-scanner MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}Codex에 document-scanner MCP 설치
$ codex mcp add document-scanner -- npx -y @guardbee/mcp-document-scannerCodex config.toml에 document-scanner MCP 설치
~/.codex/config.toml
[mcp_servers.document-scanner] command = "npx" args = ["-y", "@guardbee/mcp-document-scanner"]
Gemini CLI에 document-scanner MCP 설치
$ gemini mcp add -s user document-scanner npx -- -y @guardbee/mcp-document-scannerGemini settings.json에 document-scanner MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}document-scanner MCP 도구 3
README에서 감지됨scan_documentscan_base64list_detectors
| scan_document | — | |
| scan_base64 | — | |
| list_detectors | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기@guardbee/mcp-document-scanner
🇬🇧 English | 🇹🇷 Türkçe
An MCP server and CLI that finds personal data and credentials inside documents — PDFs, screenshots, scanned pages — before they are handed to an LLM. Text checks in a proxy or a DLP see a PDF attachment or an image as an opaque blob; this package reads it: the PDF text layer first, and OCR (Turkish and English) for images and for PDF pages that have no text.
Telemetry is off by default. With
GUARDBEE_TELEMETRY=1it sends the server, tool, success, duration and short parameter values such as a file path; longer strings and fields likecontent,tokenorpasswordare replaced with a placeholder. See@guardbee/mcp-telemetry.
document ──► type from the bytes (PDF, PNG, JPEG, GIF, WebP, BMP, TIFF, text)
│
├─ PDF page with a text layer ──► text
├─ PDF page without one ─────► render (@napi-rs/canvas) ──► OCR (tesseract.js)
└─ image ─────────────────────► OCR (tesseract.js)
│
guard-core detectors ◄──────┘ TC Kimlik No, VKN, IBAN, card (checksums),
passport, SGK, MERSİS, birth date, address,
e-mail, KEP, phone, 22+ credential formats
Install
npx -y @guardbee/mcp-document-scanner scan ./contracts # text layers only
npm i -g @guardbee/mcp-document-scanner tesseract.js @napi-rs/canvas # with OCR
OCR is optional: tesseract.js reads images, and @napi-rs/canvas (prebuilt, no compiler needed) renders scanned PDF pages for it. Without them the scanner still reads every PDF text layer and says which pages or images it could not read. Tesseract downloads the tur and eng language data (~10 MB) on first use into ~/.cache/guardbee/tessdata (or $XDG_CACHE_HOME/guardbee/tessdata) — never into your working directory. Offline: put <lang>.traineddata in a folder and pass --lang-path.
MCP tools
| Tool | What it does |
|---|---|
scan_document |
Scan a file, or every PDF and image in a folder |
scan_base64 |
Scan bytes given as base64 (an attachment, an image a tool returned); the type comes from the bytes |
list_detectors |
The personal-data and credential detectors that run |
{ "mcpServers": { "documents": { "command": "npx", "args": ["-y", "@guardbee/mcp-document-scanner"] } } }
CLI
guardbee-document-scanner scan <file|folder> [--format=text|json|sarif] [--fail-on=any|critical|high|medium|low|none]
[--no-ocr] [--lang=tur,eng] [--lang-path=<dir>] [--cache-path=<dir>] [--include=ip_address,plate_tr]
[--max-pages=50] [--max-files=500] [--text]
⚠️ Found 3 item(s) in 1 document(s) (812ms)
Critical: 0 High: 2 Medium: 1 Low: 0
contracts/acme.pdf (pdf, 2 page(s) read)
[HIGH] tc_kimlik (personal) — page 1, pdf-text: 10*******46
[HIGH] iban (personal) — page 2, pdf-ocr: TR************26
[MEDIUM] email (personal) — page 2, pdf-ocr: al***********om
Findings show only the first and last characters. --format=sarif gives SARIF 2.1.0 with the page as the line, for GitHub Code Scanning. Exit code 1 when something at or above --fail-on was found.
In the security proxy
@guardbee/mcp-security-proxy uses this package for interceptors.documents: images and embedded PDFs in tool results and resource blobs are scanned before the model sees them, and a document holding personal data or a credential is withheld (block) or logged (warn).
interceptors:
documents: { enabled: true, action: block, ocr: true, maxBytes: 26214400 }
Limits
- The type is taken from the bytes, never from a file name or a MIME type.
- 25 MB and 50 pages per document by default (
maxBytes,--max-pages). - OCR quality depends on the scan; a blurry photo can miss a digit and so fail a checksum — such a value is not reported, which errs towards silence rather than false alarms.
- Names, signatures and handwriting are not detected.
License
MIT
Feedback
Questions, ideas, or a false positive? Start a thread in GitHub Discussions or open an issue. If GuardBee is useful to you, a ⭐ on the repository helps others find it.
document-scanner MCP 질문
document-scanner MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add document-scanner -- npx -y @guardbee/mcp-document-scanner를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
document-scanner MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
document-scanner MCP는 어떤 도구를 제공하나요?
3개 도구를 제공합니다. 예: scan_document, scan_base64, list_detectors.
어떤 유형의 파일을 스캔할 수 있나요?
PDF, PNG, JPEG, GIF, WebP, BMP, TIFF 및 텍스트 파일을 지원합니다.
스캐너 작동을 위해 OCR이 필수인가요?
아니요, OCR은 선택 사항입니다. OCR 없이도 PDF 텍스트 레이어를 읽을 수 있지만, 읽지 못한 페이지나 이미지는 보고됩니다.
어떤 종류의 민감한 정보를 탐지할 수 있나요?
IBAN, 여권 번호, 이메일 주소, 전화번호 등 다양한 개인 정보와 자격 증명을 탐지합니다.
파일 크기나 길이에 제한이 있나요?
기본적으로 파일 크기는 25 MB, 문서당 페이지 수는 50페이지로 제한됩니다.