Threat Rules

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

GuardBee MCP bridge to Agent Threat Rules (ATR) for runtime agent/MCP threat detection

已驗證STDIO僅桌面安全與監控AI 與機器學習

概覽

AI 產生的概覽

本機 MCP 橋接 Agent Threat Rules(ATR),讓助理對文字、檔案與代理事件進行提示注入、工具投毒等威脅偵測。

可以做什麼
  • 依 ATR 與 GuardBee 規則評分自由文字、本機檔案與結構化 AgentEvent JSON,回傳命中結果與後續掃描器提示
  • 列出已載入的偵測規則,並依類別與來源(ATR 或 GuardBee)統計規則數量
  • 說明 ATR 執行階段規則如何補足 GuardBee 靜態 MCP 稽核工具
  • 將執行階段發現對應到 OWASP LLM 應用程式十大風險(2025)與 MITRE ATLAS
適用情境
適合需要讓助理在執行階段檢查提示詞、工具輸出、檔案或代理事件是否命中已知 AI 代理威脅模式,並據此找到對應 GuardBee 稽核工具進一步檢視的情境。
執行需求
以本機 stdio 程序執行,來自 npm 套件 @guardbee/mcp-threat-rules(需 Node.js/npx)。未宣告驗證、環境變數或標頭。可透過專案規則目錄中的 YAML 或 GUARDBEE_ATR_RULES_DIR 變數加入自訂規則。
安裝前請注意
evaluate_file 會讀取本機檔案內容並送入規則評估,請只指向願意被處理的檔案。遙測預設關閉;設定 GUARDBEE_TELEMETRY=1 後會將伺服器、工具、成功狀態、耗時及檔案路徑等短參數值傳送給第三方,較長字串與 content、token、password 等欄位會以佔位符取代。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@guardbee/mcp-threat-rules

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

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

GuardBee MCP bridge to Agent Threat Rules (ATR) — the open, Sigma-like detection standard for AI agent threats (prompt injection, tool poisoning, context exfiltration, MCP attacks).

ATR evaluates runtime events. GuardBee’s other packages mostly scan source/catalogs. This package connects both: run ATR plus GuardBee rules (KVKK / Turkish & Chinese injection / Chinese ID / lethal-trifecta intent), then jump to the matching GuardBee auditor.

Custom project rules: drop YAML into .guardbee/atr-rules/ or set GUARDBEE_ATR_RULES_DIR.

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.

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

Built-in GuardBee rules include KVKK TC Kimlik, Turkish & Chinese injection, Chinese national ID, and lethal-trifecta intent (GB-ATR-2026-00001 … 00005).

Upstream ATR is MIT-licensed and already used across the industry. We depend on agent-threat-rules rather than forking it.

Tools

ToolPurpose
evaluate_textScore free text against ATR + GuardBee rules
evaluate_fileScore a local file
evaluate_eventScore a structured ATR AgentEvent JSON
list_rulesList loaded rules (source=atr|guardbee)
rule_statsCounts by category/source
explain_bridgeHow ATR maps onto GuardBee scanners
framework_mapHow GuardBee runtime findings map to OWASP LLM Top 10 (2025) and MITRE ATLAS — the mapping guardbee-proxy report uses

CLI

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

Related GuardBee packages

ATR categoryGuardBee follow-up
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

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/threat-rules/README.md,提交 bc5997d

工具

7

evaluate_text

Evaluate free text against Agent Threat Rules (ATR) plus GuardBee KVKK/TR rules. Returns matches with follow-up scanner hints.

輸入參數lanetypeformatcontent必填scanContext

evaluate_file

Read a local file and evaluate its contents against ATR + GuardBee rules

輸入參數lanepath必填typeformat

evaluate_event

Evaluate a structured ATR AgentEvent JSON (type, content, fields, sessionId, …).

輸入參數laneevent必填format

list_rules

List loaded ATR + GuardBee detection rules (optionally filter by category or source).

輸入參數lanesourcecategory

rule_stats

Summarize loaded rule counts by category and source (ATR vs GuardBee)

輸入參數lane

explain_bridge

Explain how Agent Threat Rules (ATR) complements GuardBee static MCP auditors

無需輸入參數。

framework_map

Show how GuardBee's runtime findings map to OWASP Top 10 for LLM Applications (2025) and MITRE ATLAS — the mapping guardbee-proxy report uses

無需輸入參數。

版本歷史

9
  1. v0.5.1最新Oct 30, 2026
  2. v0.4.2Oct 22, 2026
  3. v0.3.7Oct 21, 2026
  4. v0.3.6Oct 20, 2026
  5. v0.3.4Oct 19, 2026
  6. v0.3.3Oct 16, 2026
  7. v0.3.2Oct 15, 2026
  8. v0.3.0Oct 14, 2026
  9. v0.2.1Oct 13, 2026

評分

已滿足適用檢查項的 90%

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

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

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

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