mcpField
T
threat-rules

threat-rules

本地服务
github.com/GuardBee安全22 天前更新
代码仓库

关于 threat-rules

threat-rules 是 GuardBee 的 MCP 桥接服务，可用 Agent Threat Rules（ATR）和 GuardBee 规则评估 Agent 与 MCP 的运行时事件，供安全团队检查提示词注入、工具投毒和上下文外泄等威胁。

主要功能

  1. 01评估文本、文件和结构化事件
  2. 02加载 ATR 与 GuardBee 检测规则
  3. 03列出规则并查看类别统计
  4. 04将发现映射至 OWASP LLM Top 10 和 MITRE ATLAS

适用场景

  1. 01检查提示词中的注入迹象
  2. 02评估运行时 ATR AgentEvent
  3. 03扫描本地文件中的威胁模式

MCP 相关

向 MCP 客户端提供威胁评估、规则查询、统计、桥接说明和框架映射工具。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "guardbee-threat-rules": {
      "command": "npx",
      "args": [
        "-y",
        "@guardbee/mcp-threat-rules"
      ]
    }
  }
}
启动命令npx -y @guardbee/mcp-threat-rules

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

安装包
npm@guardbee/mcp-threat-rules0.5.1

工具

7

收录的工具列表 · 更新于 6 天前

参数类型必填说明
laneenum否检测通道（默认值：hunt）enforce | alert | hunt
typeenum否ATR 事件类型（默认值：llm_input）llm_input | llm_output | tool_call | tool_response | agent_behavior | multi_agent_message | mcp_exchange
formatenum否text | json | sarif
contentstring是要评估的文本
scanContextenum否mcp | skill

详细介绍

@guardbee/mcp-threat-rules

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

npm version npm downloads License: MIT

GuardBee MCP 与 Agent Threat Rules（ATR） 的桥接工具——这是针对 AI Agent 威胁（提示词注入、工具投毒、上下文窃取、MCP 攻击）的开放式、类似 Sigma 的检测标准。

ATR 评估运行时事件。GuardBee 的其他软件包主要扫描源代码/目录。本软件包将两者连接起来：运行 ATR 以及 GuardBee 规则（KVKK / 土耳其语和中文注入 / 中国身份证 / 致命三元组意图），然后跳转到匹配的 GuardBee 审计工具。

自定义项目规则：将 YAML 文件放入 .guardbee/atr-rules/，或设置 GUARDBEE_ATR_RULES_DIR。

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

Claude ──► threat-rules (ATR) ──► matches + GuardBee follow-up hints
              │
              ├─ evaluate_text / evaluate_file / evaluate_event
              ├─ list_rules / rule_stats
              └─ explain_bridge

内置 GuardBee 规则包括 KVKK TC Kimlik、土耳其语和中文注入、中国国民身份证，以及致命三元组意图（GB-ATR-2026-00001 … 00005）。

上游 ATR 采用 MIT 许可证，且已在业内广泛使用。我们依赖 agent-threat-rules，而不是对其进行分叉。

工具

工具用途
evaluate_text根据 ATR + GuardBee 规则评估自由文本
evaluate_file评估本地文件
evaluate_event评估结构化的 ATR AgentEvent JSON
list_rules列出已加载的规则（source=atr|guardbee）
rule_stats按类别/来源统计数量
explain_bridge说明 ATR 如何映射到 GuardBee 扫描器
framework_map说明 GuardBee 运行时发现如何映射到 OWASP LLM Top 10（2025）和 MITRE ATLAS——guardbee-proxy report 使用的映射

命令行

npx @guardbee/mcp-threat-rules eval "…" --format=json --fail-on=high
npx @guardbee/mcp-threat-rules scan ./prompt.txt --format=sarif
npx @guardbee/mcp-threat-rules list --source=guardbee
npx @guardbee/mcp-threat-rules stats

相关 GuardBee 软件包

ATR 类别GuardBee 后续处理
prompt-injection@guardbee/mcp-prompt-injection-scanner
tool-poisoning@guardbee/mcp-tool-poisoning-scanner
context-exfiltration@guardbee/mcp-toxic-flow-auditor、@guardbee/mcp-prompt-leak-scanner
privilege-escalation@guardbee/mcp-oauth-auditor、@guardbee/mcp-server-auditor

反馈

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。