PDF'leri, ekran görüntülerini ve taranmış belgeleri, bir LLM'e gönderilmeden önce metin katmanlarını ve OCR kullanarak tarar; PII (kişisel veriler) ve kimlik bilgilerini tespit eder.
Ayrıca bilinen adı GuardBee/guardbee-mcp, @guardbee/mcp-document-scanner
- Yıldızlar
- 2
- Araçlar
- 3
- İndirmeler, 30 gün
- 3.086
- En son sürüm
- 0.4.1
- Son commit
- 12 Kas 2026
- Lisans
- MIT
document-scanner MCP nedir?
document-scanner bir MCP sunucusudur. PDF'leri, ekran görüntülerini ve taranmış belgeleri, bir LLM'e gönderilmeden önce metin katmanlarını ve OCR kullanarak tarar; PII (kişisel veriler) ve kimlik bilgilerini tespit eder. 3 araç sunar; örneğin scan_document, scan_base64, list_detectors.
Özet, projenin README dosyasından oluşturuldu
document-scanner MCP sunucusu hakkında
Bu aracın temel işlevi, hassas bilgilerin büyük dil modellerine gönderilmesini engellemektir. PDF'leri, ekran görüntülerini ve çeşitli görsel formatlarını, bir AI istemcisine ulaşmadan önce kişisel verileri ve kimlik bilgilerini tanımlamak için tarar. Metin katmanlarını analiz ederek ve taranmış sayfalar veya görseller için OCR kullanarak IBAN, pasaport numarası, e-posta adresi ve telefon numarası gibi belirli kalıpları tespit eder.
Yazılımcılar bu sunucuyu npx kullanarak yerel MCP kurulumlarına entegre edebilir veya npm üzerinden yükleyebilirler. tesseract.js aracılığıyla İngilizce ve Türkçe desteği sunar ve işleme için @napi-rs/canvas kullanır. Sistem, dosya türlerini dosya adlarına veya MIME türlerine güvenmek yerine doğrudan baytlar üzerinden tanımlar. Standart kimlik formatlarının yanı sıra TC Kimlik No ve MERSİS gibi Türkçe tanımlayıcılar için özel dedektörler içerir. Kullanıcılar, işlem yükünü yönetmek için 25 MB dosya boyutu veya belge başına maksimum 50 sayfa gibi sınırları yapılandırabilirler.
Neler yapabilirsiniz
- 1Otomatik belge güvenlik denetimiGitHub Code Scanning için bir SARIF raporu oluşturmak amacıyla bir dosya dizini üzerinde komut satırı taraması çalıştırın.
- 2Türkiye'ye özgü tanımlayıcıların tespitiTaranmış belgeler içindeki VKN veya MERSİS numaraları gibi hassas Türkçe verileri tanımlayın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
document-scanner MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekledocument-scanner MCP'yi Claude Code içine yükleyin
$ claude mcp add document-scanner -- npx -y @guardbee/mcp-document-scannerdocument-scanner MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}document-scanner MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"document-scanner": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}document-scanner MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"document-scanner","type":"stdio","command":"npx","args":["-y","@guardbee/mcp-document-scanner"]}'document-scanner MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}document-scanner MCP'yi Codex içine yükleyin
$ codex mcp add document-scanner -- npx -y @guardbee/mcp-document-scannerdocument-scanner MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.document-scanner] command = "npx" args = ["-y", "@guardbee/mcp-document-scanner"]
document-scanner MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user document-scanner npx -- -y @guardbee/mcp-document-scannerdocument-scanner MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"document-scanner": {
"command": "npx",
"args": [
"-y",
"@guardbee/mcp-document-scanner"
]
}
}
}document-scanner MCP araçları 3
README dosyasından algılandıscan_documentscan_base64list_detectors
| scan_document | — | |
| scan_base64 | — | |
| list_detectors | — |
Otomatik kontroller
Çalıştırıldı 13 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şilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@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 soruları
document-scanner MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add document-scanner -- npx -y @guardbee/mcp-document-scanner komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
document-scanner 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.
document-scanner MCP hangi araçları sunar?
3 araç sunar; bunlar arasında scan_document, scan_base64, list_detectors yer alır.
Hangi dosya türleri taranabilir?
Tarayıcı PDF, PNG, JPEG, GIF, WebP, BMP, TIFF ve metin dosyalarını destekler.
Tarayıcının çalışması için OCR gerekli mi?
Hayır, OCR isteğe bağlıdır. OCR olmadan tarayıcı PDF metin katmanını okur ancak okuyamadığı sayfa veya görselleri raporlar.
Ne tür hassas bilgileri tespit edebilir?
IBAN, pasaport numaraları, e-posta adresleri, telefon numaraları ve daha fazlası dahil olmak üzere çeşitli kişisel verileri ve kimlik bilgilerini tespit eder.
Dosya boyutu veya uzunluğu konusunda herhangi bir sınırlama var mı?
Varsayılan olarak tarayıcı, belge başına 25 MB ve 50 sayfa ile sınırlıdır.