Vulnerability Scanner

io.github.GuardBee由 GitHub 账号 GuardBee 发布v0.4.1更新于 Nov 3, 2026

Triggers GuardBee scans, queries findings, AI-assisted remediation guidance

已验证STDIO仅桌面网页搜索与抓取安全与监控

概览

AI 生成的概览

让 AI 助手对网址发起 GuardBee 安全扫描，并返回漏洞发现与修复建议。

可以做什么
  • 对网址或品牌 ID 发起 GuardBee 扫描，可选择等待扫描完成
  • 按扫描 ID 查询扫描状态与各类别计数摘要
  • 列出工作区最近的扫描记录并支持筛选
  • 按严重程度、扫描 ID 或品牌 ID 获取漏洞发现，含标题、描述与修复建议
  • 执行完整扫描并直接返回严重与高危问题及修复指引
适用场景
适合让助手对站点执行 OWASP 类安全检查、汇总严重与高危问题并给出修复方案，也支持以 KVKK、GDPR 或 CCPA 合规为重点的扫描。
运行要求
通过 npm 包以 stdio 在本地运行，通常用 npx 启动。需要在 GUARDBEE_API_KEY 环境变量中提供 GuardBee API 密钥；可选 GUARDBEE_BASE_URL 覆盖默认端点。需要能访问 GuardBee 服务的网络。
安装前请注意
API 密钥属于凭据，通过环境变量传入。扫描会针对真实网址发起并消耗 GuardBee 工作区资源。设置 GUARDBEE_TELEMETRY=1 可开启遥测，会向遥测包发送服务器、工具、成功与否、耗时及文件路径等短参数值，较长字符串以及 content、token、password 等字段会被替换为占位符。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Vulnerability Scanner，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@guardbee/mcp-vulnerability-scanner

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

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

Trigger a GuardBee security scan directly from a Claude conversation. Run OWASP checks, query findings, and have the AI prioritize remediation recommendations.

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. Get one at app.guardbee.ai/developers.

Features

  • Trigger a Scan from Claude — start a GuardBee scan on any URL with one command
  • Status Queries — check scan progress and summary counts in real time
  • Finding Filters — query by severity, scan ID, or brand ID
  • Remediation Guidance — an explanation and an actionable recommendation for every finding
  • Scan Scenarios — quick, kvkkFocus, gdprFocus, ccpaFocus
  • 36 Scan Modules — all of GuardBee's modules are supported
  • 25 Unit Tests — a test suite that doesn't require API calls

Quick Start

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

Add to claude_desktop_config.json:

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

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

MCP Tools

ToolDescription
start_scanStarts a scan for a URL or brand ID; with wait=true waits for completion
get_scan_statusLive status and summary counts by scan ID
list_scansLists workspace scans with filters
get_findingsFetches findings filtered by severity / scanId / brandId
scan_and_reportScan + wait + return critical/high findings and remediation recommendations

Example Usage

You can ask Claude:

"Scan https://example.com and give me a security report"

"List my recent scans"

"Show critical findings for scan clz001 and explain how to fix them"

"Run a KVKK-focused scan on example.com"

Example Output

⚠️  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.

Scan Scenarios

ScenarioDescription
quickAll 36 modules — comprehensive general scan
kvkkFocusFocused on KVKK compliance modules
gdprFocusFocused on GDPR compliance modules
ccpaFocusFocused on CCPA compliance modules

Environment Variables

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

Development

bash
npm installnpm test          # 25 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/vulnerability-scanner/README.md，提交 bc5997d

工具

5

start_scan

Start a GuardBee security scan on a URL. Returns a scan ID you can use to check status and get findings.

输入参数urlwaitbrandIdscenario

get_scan_status

Get the current status and summary of a GuardBee scan by ID

输入参数scanId必填

list_scans

List recent GuardBee scans in your workspace

输入参数pagestatusbrandIdpageSize

get_findings

Get vulnerability findings from a GuardBee scan with optional severity filter. Includes title, description, and remediation recommendation per finding.

输入参数pagescanIdbrandIdpageSizeseverity

scan_and_report

Run a full GuardBee scan and immediately return all critical and high findings with remediation guidance. Best for quick security assessments.

输入参数url必填scenario

版本历史

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 分