threat-rules について
threat-rules は、Agent Threat Rules(ATR)と GuardBee ルールでエージェントや MCP の実行時イベントを評価する GuardBee の MCP ブリッジです。プロンプトインジェクション、ツールポイズニング、コンテキスト流出などの確認に利用できます。
主な機能
- 01テキスト、ファイル、構造化イベントの評価
- 02ATR と GuardBee の検出ルール読み込み
- 03ルール一覧とカテゴリ別統計
- 04検出結果を OWASP LLM Top 10 と MITRE ATLAS に対応付け
活用シーン
- 01プロンプトのインジェクション兆候の確認
- 02実行時 ATR AgentEvent の評価
- 03ローカルファイルの脅威パターン検査
MCP 対応
脅威評価、ルール照会、統計、ブリッジの説明、フレームワーク対応付けを MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
7掲載時のツール一覧 · 6 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| lane | enum | いいえ | 検出レーン(デフォルト:hunt)enforce | alert | hunt |
| type | enum | いいえ | ATR イベントタイプ(デフォルト:llm_input)llm_input | llm_output | tool_call | tool_response | agent_behavior | multi_agent_message | mcp_exchange |
| format | enum | いいえ | text | json | sarif |
| content | string | はい | 評価するテキスト |
| scanContext | enum | いいえ | mcp | skill |
詳細
@guardbee/mcp-threat-rules
🇬🇧 英語 | 🇹🇷 トルコ語 | 🇨🇳 中国語 | 🇯🇵 日本語 | 🇰🇷 韓国語 | 🇧🇷 ポルトガル語 | 🇪🇸 スペイン語 | 🇩🇪 ドイツ語
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_bridge | ATR と GuardBee スキャナーの対応関係を説明します |
framework_map | GuardBee の実行時検出結果と 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 が役に立った場合は、リポジトリに ⭐ を付けていただけると、ほかの人にも見つけてもらいやすくなります。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。