Compliance Checker

io.github.GuardBee由 GitHub 帳號 GuardBee 發布v0.4.1更新於 Nov 3, 2026

KVKK/GDPR/CCPA compliance checks for codebases

概覽

AI 產生的概覽

透過 GuardBee API 對網址執行 KVKK、GDPR 與 CCPA 合規掃描,分析隱私政策並比較各法規要求。

可以做什麼
  • 針對 KVKK、GDPR 或 CCPA 對網址執行完整合規掃描,回傳落差分析與行動計畫
  • 取得已完成掃描的結果,可依法規框架或嚴重程度篩選
  • 擷取隱私政策頁面,依十項合規訊號評分並給出等級
  • 列出各法規框架的具體要求與法條依據
  • 並列比較 KVKK、GDPR 與 CCPA 的要求異同
適用情境
適合需要快速檢查網站或其隱私政策的資料保護合規狀況,或想了解 KVKK、GDPR 與 CCPA 要求差異的情況。要求清單與框架比較不需帳號即可使用。
執行需求
以 npm 套件形式透過 stdio 在本機執行(需 Node.js)。掃描與結果查詢工具需要環境變數 GUARDBEE_API_KEY 中的 GuardBee API 金鑰,其餘三個工具不需金鑰。可用 GUARDBEE_BASE_URL 指定自訂端點。需要連線至 GuardBee 服務的網路存取。
安裝前請注意
掃描與結果查詢工具會把目標網址傳送給 GuardBee API,並需要 GuardBee API 金鑰;隱私政策工具會擷取所給網址。遙測預設關閉,但設定 GUARDBEE_TELEMETRY=1 後會將工具名稱、成功狀態、耗時及檔案路徑等短參數值傳送至遙測套件。結果僅為自動化訊號,不構成法律意見。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Compliance Checker,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@guardbee/mcp-compliance-checker

🇬🇧 English | 🇹🇷 Türkçe | 🇨🇳 中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇧🇷 Português | 🇪🇸 Español | 🇩🇪 Deutsch

[npm version] [npm downloads] [License: MIT]

An MCP server that runs KVKK (Turkish data protection law), GDPR, and CCPA compliance checks via the GuardBee API, analyzes privacy policies, and compares legal requirements. Three of its tools work without an API key.

Telemetry is off by default. With GUARDBEE_TELEMETRY=1 it sends the server, tool, success, duration and short parameter values such as a file path; longer strings and fields like content, token or password are replaced with a placeholder. See @guardbee/mcp-telemetry.

A GuardBee API key is required for the check_compliance and get_compliance_findings tools. Get one at app.guardbee.ai/developers.


Features

  • KVKK / GDPR / CCPA Scanning — triggers a compliance-focused scan via the GuardBee API and fetches findings
  • Privacy Policy Analysis — fetches policy text from a URL; 10 compliance signals, a score (0-100), and a letter grade
  • Cookie Banner Detection — detects OneTrust, Cookiebot, Axeptio, and 10+ CMP platforms
  • Requirements Catalog — 21 requirements with legal-article references across KVKK (9), GDPR (8), CCPA (4)
  • Framework Comparison — common and differing articles across KVKK / GDPR / CCPA
  • Key-Free Tools — analyze_privacy_policy, list_requirements, compare_frameworks work offline

Quick Start

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

Add to claude_desktop_config.json:

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

Get your API key at app.guardbee.ai/developers.


MCP Tools

ToolAPI KeyDescription
check_complianceRequiredStarts a compliance scan (KVKK/GDPR/CCPA) for a URL
get_compliance_findingsRequiredFetches scan findings, filterable by framework and severity
analyze_privacy_policyNoAnalyzes a privacy policy URL — score, grade, missing clauses
list_requirementsNoLists legal requirements for supported frameworks
compare_frameworksNoCompares similarities and differences across KVKK, GDPR, and CCPA

Example Usage

You can ask Claude:

"Check example.com's KVKK compliance"

"List GDPR requirements"

"Compare the differences between KVKK and GDPR"

"Analyze the privacy policy at https://example.com/privacy"

Example Output

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.

Supported Frameworks

FrameworkRequirement CountScan Scenario
KVKK9kvkkFocus
GDPR8gdprFocus
CCPA4ccpaFocus

Privacy Policy Scoring

The analyze_privacy_policy tool looks for 10 signals in the policy text:

SignalDescription
Data controller identityCompany/organization name is stated
Purpose of processingWhy the personal data is being collected
Legal basisReference to GDPR Art. 6 / KVKK Art. 5
Retention periodsHow long the data will be kept
Data subject rightsAccess, erasure, portability, objection
Contact / DPOHow to reach the data controller
Cookie policyCookies and tracking technologies
Third-party sharingParties the data is shared with
Security measuresTechnical/administrative safeguards
International transferCross-border transfer safeguards

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


Environment Variables

VariableDescription
GUARDBEE_API_KEYGuardBee API key (required for check_compliance and get_compliance_findings)
GUARDBEE_BASE_URLCustom endpoint (default: https://app.guardbee.ai)

Development

bash
npm installnpm test          # unit testsnpm run build     # TypeScript compile

License

MIT — GuardBee

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.

來源:packages/compliance-checker/README.md,提交 bc5997d

工具

5

check_compliance

Run a full compliance scan for a URL against a regulatory framework (KVKK, GDPR, or CCPA) using the GuardBee scanner. Returns a gap analysis and action plan.

輸入參數url必填waitframework必填

get_compliance_findings

Get compliance findings from a completed GuardBee scan, optionally filtered by severity

輸入參數scanId必填severityframework

analyze_privacy_policy

Fetch and analyze a privacy policy page for completeness against GDPR/KVKK requirements. Works without an API key.

輸入參數url必填

list_requirements

List all compliance requirements for a framework with legal basis references

輸入參數severityframework必填

compare_frameworks

Compare KVKK, GDPR, and CCPA requirements side by side to understand overlaps and gaps

無需輸入參數。

版本歷史

3
  1. v0.4.1最新Oct 30, 2026
  2. v0.3.2Oct 22, 2026
  3. v0.2.5Oct 13, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分