@guardbee/mcp-compliance-checker

npm version npm downloads License: MIT

KVKK, GDPR ve CCPA uyum kontrollerini GuardBee API ile çalıştıran, gizlilik politikalarını analiz eden ve yasal gereksinimleri karşılaştıran MCP sunucusu. Üç araç API anahtarı gerektirmeden çalışır.

GuardBee API anahtarı check_compliance ve get_compliance_findings araçları için gereklidir. app.guardbee.ai/developers adresinden alın.

Özellikler

KVKK / GDPR / CCPA Taraması — GuardBee API ile uyum odaklı tarama başlatır ve bulguları getirir
Gizlilik Politikası Analizi — URL'den politika metnini çeker; 10 uyum sinyali, puan (0-100) ve harf notu
Çerez Banner Tespiti — OneTrust, Cookiebot, Axeptio ve 10+ CMP platform tespiti
Gereksinim Kataloğu — KVKK (9), GDPR (8), CCPA (4) yasal madde referanslarıyla 21 gereksinim
Çerçeve Karşılaştırması — KVKK / GDPR / CCPA arasındaki ortak ve farklı maddeler
API Anahtarsız Araçlar — analyze_privacy_policy, list_requirements, compare_frameworks çevrimdışı çalışır

Hızlı Başlangıç

npm install -g @guardbee/mcp-compliance-checker

claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "guardbee-compliance-checker": {
      "command": "npx",
      "args": ["-y", "@guardbee/mcp-compliance-checker"],
      "env": {
        "GUARDBEE_API_KEY": "gb_..."
      }
    }
  }
}

API anahtarınızı app.guardbee.ai/developers adresinden alın.

MCP Tools

Tool	API Anahtarı	Açıklama
`check_compliance`	Gerekli	URL veya brand ID için uyum taraması başlatır (KVKK/GDPR/CCPA)
`get_compliance_findings`	Gerekli	Tarama bulgularını çerçeve ve severity filtresiyle getirir
`analyze_privacy_policy`	Hayır	Gizlilik politikası URL'sini analiz eder; puan, not ve eksik maddeler
`list_requirements`	Hayır	Desteklenen çerçeveler için yasal gereksinimleri listeler
`compare_frameworks`	Hayır	KVKK, GDPR ve CCPA arasındaki benzerlikleri ve farklılıkları karşılaştırır

Örnek Kullanım

Claude'a şunu sorabilirsiniz:

"example.com'un KVKK uyumunu kontrol et"

"GDPR gereksinimlerini listele"

"KVKK ile GDPR arasındaki farkları karşılaştır"

"https://example.com/privacy adresindeki gizlilik politikasını analiz et"

Örnek Çıktı

Privacy Policy Analysis: https://example.com/privacy
──────────────────────────────────────────────────────
Score : 72/100  Grade: C

✅ Data controller identity disclosed
✅ Purpose of processing stated
✅ Retention periods mentioned
✅ Cookie policy present
❌ Legal basis for processing not stated
❌ Data subject rights not listed (access, erasure, portability)
❌ International transfer safeguards missing
❌ Contact information for DPO missing

Recommendation: Add legal basis statements and data subject rights section.

Desteklenen Çerçeveler

Çerçeve	Gereksinim Sayısı	Tarama Senaryosu
KVKK	9	`kvkkFocus`
GDPR	8	`gdprFocus`
CCPA	4	`ccpaFocus`

Gizlilik Politikası Puanlaması

analyze_privacy_policy aracı politika metninde 10 sinyal arar:

Sinyal	Açıklama
Veri sorumlusu kimliği	Şirket/kuruluş adı belirtilmiş
İşleme amacı	Kişisel verinin neden toplandığı
Hukuki dayanak	GDPR Art. 6 / KVKK Md. 5 referansı
Saklama süreleri	Verinin ne kadar tutulacağı
İlgili kişi hakları	Erişim, silme, taşınabilirlik, itiraz
İletişim / DPO	Veri sorumlusuna ulaşma bilgisi
Çerez politikası	Çerezler ve izleme teknolojileri
Üçüncü taraf paylaşımı	Veri paylaşılan taraflar
Güvenlik önlemleri	Teknik/idari tedbirler
Uluslararası transfer	Yurt dışı aktarım güvenceleri

Notlar: A (90-100) · B (75-89) · C (60-74) · D (45-59) · F (0-44)

Ortam Değişkenleri

Değişken	Açıklama
`GUARDBEE_API_KEY`	GuardBee API anahtarı (check_compliance ve get_compliance_findings için zorunlu)
`GUARDBEE_BASE_URL`	Özel endpoint (varsayılan: `https://app.guardbee.ai`)

Geliştirme

npm install
npm test          # unit testler
npm run build     # TypeScript derleme

Lisans

MIT — GuardBee