vulnerability-scanner

@guardbee/mcp-vulnerability-scanner

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

直接在 Claude 对话中触发 GuardBee 安全扫描。运行 OWASP 检查、查询发现项，并让 AI 为修复建议确定优先级。

默认情况下，遥测功能处于关闭状态。设置 GUARDBEE_TELEMETRY=1 后，它会发送服务、工具、成功状态、耗时以及文件路径等简短参数值；较长的字符串以及 content、token 或 password 等字段会替换为占位符。请参阅 @guardbee/mcp-telemetry。

需要 GuardBee API 密钥。 请前往 app.guardbee.ai/developers 获取。

---

功能

• 通过 Claude 触发扫描 — 只需一条命令，即可对任意 URL 启动 GuardBee 扫描
• 状态查询 — 实时查看扫描进度和摘要计数
• 发现项筛选 — 按严重程度、扫描 ID 或品牌 ID 查询
• 修复指导 — 为每个发现项提供说明和可执行的建议
• 扫描场景 — quick、kvkkFocus、gdprFocus、ccpaFocus
• 36 个扫描模块 — 支持 GuardBee 的所有模块
• 25 个单元测试 — 无需 API 调用即可运行的测试套件

---

快速开始

npm install -g @guardbee/mcp-vulnerability-scanner

添加到 claude_desktop_config.json：

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

请前往 app.guardbee.ai/developers 获取 API 密钥。

---

MCP 工具

工具	描述
start_scan	为 URL 或品牌 ID 启动扫描；设置 wait=true 时会等待扫描完成
get_scan_status	按扫描 ID 查询实时状态和摘要计数
list_scans	列出工作区扫描记录，并支持筛选
get_findings	获取按严重程度 / scanId / brandId 筛选的发现项
scan_and_report	扫描 + 等待 + 返回严重 / 高危发现项和修复建议

使用示例

你可以向 Claude 提问：

“扫描 https://example.com 并提供安全报告”

“列出我最近的扫描”

“显示扫描 clz001 的严重发现项，并解释如何修复”

“对 example.com 运行一次以 KVKK 为重点的扫描”

输出示例

⚠️  Security scan complete for https://example.com
   Scan ID  : clz001abc
   🔴 Critical : 2
   🟠 High     : 5
   🟡 Medium   : 8
   🔵 Low      : 3
   ⚪ Info     : 12
   ✅ Passed   : 18

Use get_findings with scanId="clz001abc" to see details and remediation steps.

---

扫描场景

场景	描述
quick	全部 36 个模块 — 全面的通用扫描
kvkkFocus	重点检查 KVKK 合规模块
gdprFocus	重点检查 GDPR 合规模块
ccpaFocus	重点检查 CCPA 合规模块

---

环境变量

变量	描述
GUARDBEE_API_KEY	GuardBee API 密钥 （必需）
GUARDBEE_BASE_URL	自定义端点（默认值：https://app.guardbee.ai）

---

开发

npm install
npm test          # 25 unit tests
npm run build     # TypeScript compile

---

许可证

MIT — GuardBee

反馈

有问题、想法或遇到误报？请在 GitHub 讨论区中发起讨论，或提交问题。如果 GuardBee 对你有帮助，可以在代码仓库点个 ⭐，帮助其他人找到它。