security-suite

本地服务

github.com/GuardBee安全11 天前更新

代码仓库

关于 security-suite

security-suite 将多个 GuardBee 安全工具整合到一个 MCP 服务中，并提供运行单项检查的命令行工具，适用于评估代码、依赖项、网络服务和 AI Agent 配置。

主要功能

01通过单个服务提供所选 GuardBee 工具
02支持推荐及自定义工具组
03检查代码、依赖项和网络
04通过命令行运行各项检查

适用场景

01扫描代码库中的 MCP 安全风险
02检查依赖项中的已知 CVE
03检查网络服务和 TLS
04在 CI 流水线中运行安全检查

MCP 相关

通过单个 MCP 服务运行所选的 GuardBee 安全工具。客户端可选择工具组或单个软件包。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "4hmetuyar-security-suite": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/security-suite"
      ]
    }
  }
}

启动命令npx -y @guardbee/security-suite

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@guardbee/security-suite0.2.3stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@guardbee/security-suite

一次安装即可使用 GuardBee 的所有 MCP 安全工具。guardbee serve 会启动一个 MCP 服务，包含你选择的软件包中的工具；guardbee <package> … 则运行任意软件包的 CLI。共 30 个软件包、127 个 MCP 工具。

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

快速开始

{
  "mcpServers": {
    "guardbee": {
      "command": "npx",
      "args": ["-y", "@guardbee/security-suite", "serve"]
    }
  }
}

这将提供推荐工具集（31 个工具）：一次性扫描 OWASP MCP Top 10、机密信息、提示词注入、有害流程、MCP 客户端配置和依赖项 CVE。使用 --tools 选择其他工具：

"args": ["-y", "@guardbee/security-suite", "serve", "--tools=recommended,network"]

--tools 可接受以逗号分隔的组名和软件包 ID，也可接受 all（127 个工具；部分客户端会限制工具数量，包括 Cursor）。环境变量 GUARDBEE_SUITE_TOOLS 具有相同作用。每个工具的名称都以其所属软件包的前缀开头，因此两个软件包中的 scan_text 工具不会冲突：secrets_scan_text、injection_scan_text。名称已能表明用途的工具则保持原样（owasp_scan_path、inspect_ssl）。

分组

分组	覆盖内容
`recommended`（默认）	owasp-scan、secret-scanner、prompt-injection-scanner、toxic-flow-auditor、mcp-config-auditor、dependency-auditor
`code`	对磁盘上的源代码、配置和内容进行静态检查
`supply-chain`	依赖项、幻觉生成的软件包、模型文件、MCP 客户端配置、工具定义偏差
`network`	会连接主机进行检查的工具：TLS、DNS、向量存储、在线 LLM
`platform`	调用 GuardBee 平台的工具（需要 `GUARDBEE_API_KEY`）
`all`	所有软件包

软件包

Id	工具前缀	检查内容	分组
`owasp-scan`	`owasp_`	一次性扫描代码库或在线服务中的 OWASP MCP Top 10，并给出 A–F 评级	推荐、代码
`secret-scanner`	`secrets_`	检查文件、git 历史记录和 Agent 对话记录中的 API 密钥、令牌和密码	推荐、代码
`prompt-injection-scanner`	`injection_`	检查文档、网页和 RAG 内容中的提示词注入	推荐、代码
`toxic-flow-auditor`	`toxic_flow_`	检查单个 Agent 中的致命三要素：不可信输入、敏感数据和外传	推荐、代码
`mcp-config-auditor`	`mcp_config_`	检查 MCP 客户端配置（Cursor、Claude、Windsurf、VS Code）和影子服务	推荐、供应链
`dependency-auditor`	`deps_`	检查 npm 和 PyPI 依赖项中的已知 CVE（OSV）	推荐、供应链
`prompt-leak-scanner`	`leak_`	检查应用向外发送的大模型提示词中的凭据和个人身份信息（PII）	代码
`tool-poisoning-scanner`	`poisoning_`	检查 MCP 工具描述和架构中的隐藏指令	代码
`mcp-server-auditor`	`server_audit_`	检查 MCP 服务源代码中的 Shell、eval、SSRF 和密钥	代码
`oauth-auditor`	`oauth_`	检查 MCP 服务认证代码中的 OAuth 2.1 错误：令牌透传、受众、PKCE	代码
`audit-gap-auditor`	`audit_gap_`	检查缺少审计跟踪的工具调用（OWASP MCP08）	代码
`context-oversharing-auditor`	`oversharing_`	检查上下文过度共享（MCP10）：会话转储、跨用户上下文、未限定范围的召回	代码
`ai-code-scanner`	`ai_code_`	检查不安全的大模型集成：暴露的密钥、不安全的模型输出、发送给第三方大模型的个人身份信息	代码
`agent-graph-auditor`	`agent_graph_`	检查 LangGraph、CrewAI 和 AutoGen Agent 之间的传递性过度权限	代码
`a2a-auditor`	`a2a_`	检查 Agent2Agent (A2A) 实现代码：Webhook SSRF、未经身份验证的 Agent Card	代码
`elicitation-auditor`	`elicitation_`	检查 MCP 引导是否向用户索取密钥或将其发送给第三方	代码
`memory-poisoning-scanner`	`memory_`	检查写入持久化 Agent 记忆的不可信输入	代码
`unbounded-consumption-auditor`	`consumption_`	检查资源耗尽风险：缺少令牌限制、超时和循环边界	代码
`threat-rules`	`threat_rules_`	对文本、文件和 Agent 事件执行 Agent Threat Rules (ATR) 检查	代码
`document-scanner`	`document_`	在 PDF 和图像（OCR）到达大模型之前，检查其中的个人身份信息和凭据	代码
`reverse-shield`	`reverse_`	检查已发布应用被逆向工程的难易程度：源映射、混淆、调试信息、Electron 熔断器、APK 标志	代码
`slopsquat-scanner`	`slopsquat_`	检查幻觉生成或刚创建的包名称（slopsquatting）	供应链
`model-scanner`	`model_`	检查恶意 pickle、safetensors、Keras 和 ONNX 模型文件	供应链
`rug-pull-detector`	`rug_pull_`	检查你批准后发生变化的 MCP 工具定义	供应链
`ssl-inspector`	`ssl_`	检查 TLS 证书、加密套件和 HSTS	网络
`dns-intelligence`	`dns_`	检查 DNS 记录、SPF/DMARC/DKIM 和子域接管	网络
`vector-store-scanner`	`vector_store_`	检查未经身份验证的向量数据库（Weaviate、Qdrant、Chroma、pgvector…）	网络
`llm-redteam`	`redteam_`	针对你控制的大模型端点执行越狱和信息提取探测	网络
`vulnerability-scanner`	`vuln_`	执行 GuardBee 平台安全扫描并查看其发现结果	平台
`compliance-checker`	`compliance_`	通过 GuardBee API 检查网站是否符合 KVKK、GDPR 和 CCPA	平台

guardbee list 会打印此表。代理（mcp-security-proxy）和数据库网关（mcp-db-gateway）不属于该套件：它们位于其他服务前面，而不是响应工具调用。

CLI

npm install -g @guardbee/security-suite

guardbee list                                         # packages and groups
guardbee owasp-scan scan . --fail-on=high --format=sarif > owasp.sarif
guardbee secret-scanner scan . --history              # any package's CLI, same arguments
guardbee mcp-config-auditor discover

早期版本中的快捷命令仍然可用：

快捷命令	运行
`guardbee secret-scan <path>`	`secret-scanner scan`
`guardbee dep-audit <dir>`	`dependency-auditor audit`
`guardbee ssl-inspect <domain>…`	`ssl-inspector inspect`
`guardbee dns-check <domain>`	`dns-intelligence check`

GitHub Actions

- run: npx -y @guardbee/security-suite owasp-scan scan . --format=sarif --fail-on=high > owasp.sarif
- run: npx -y @guardbee/security-suite dep-audit . --fail-on=high
- uses: github/codeql-action/upload-sarif@v3
  if: always()
  with:
    sarif_file: owasp.sarif

从 0.2 升级

guardbee serve 以前会从四个软件包提供五个工具，并使用不带前缀的名称（scan_directory、scan_file、audit_dependencies、inspect_ssl、check_dns）。现在，它会提供推荐工具组，并使用带前缀的名称：相同的检查对应 secrets_scan_directory、secrets_scan_file、deps_audit_directory；使用 --tools=recommended,network 时，还会提供 inspect_ssl 和 enumerate_dns / dns_check_email_security。按名称调用工具的 Agent 需要使用新名称。