mcpField
T
threat-rules

threat-rules

ローカル
github.com/GuardBeeセキュリティ22 日前に更新

threat-rules について

threat-rules は、Agent Threat Rules(ATR)と GuardBee ルールでエージェントや MCP の実行時イベントを評価する GuardBee の MCP ブリッジです。プロンプトインジェクション、ツールポイズニング、コンテキスト流出などの確認に利用できます。

主な機能

  1. 01テキスト、ファイル、構造化イベントの評価
  2. 02ATR と 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

🇬🇧 英語 | 🇹🇷 トルコ語 | 🇨🇳 中国語 | 🇯🇵 日本語 | 🇰🇷 韓国語 | 🇧🇷 ポルトガル語 | 🇪🇸 スペイン語 | 🇩🇪 ドイツ語

npm version npm downloads License: MIT

AI エージェントへの脅威(プロンプトインジェクション、ツールポイズニング、コンテキストの流出、MCP 攻撃)を検出する、オープンで Sigma に似た標準である**Agent Threat Rules(ATR)**への GuardBee MCP ブリッジです。

ATR は実行時イベントを評価します。他の GuardBee パッケージの多くは、主にソース/カタログをスキャンします。このパッケージは両者をつなぎ、ATR に加えて GuardBee ルール(KVKK/トルコ語・中国語のインジェクション/中国の ID/致命的トライアドの意図)を実行し、一致する 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、トルコ語・中国語のインジェクション、中国の国民 ID、致命的トライアドの意図(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_bridgeATR と GuardBee スキャナーの対応関係を説明します
framework_mapGuardBee の実行時検出結果と OWASP LLM Top 10 (2025) および MITRE ATLAS の対応関係を説明します。このマッピングは guardbee-proxy report で使用されます

CLI

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でスレッドを立てるか、issue を作成してください。GuardBee が役に立った場合は、リポジトリに ⭐ を付けていただけると、ほかの人にも見つけてもらいやすくなります。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。