toxic-flow-auditor

@guardbee/mcp-toxic-flow-auditor

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

MCP のツールカタログを監査し、有害なフローを検出する MCP サーバーです。Simon Willison の 致命的な三要素を対象とします。

1. 信頼できないコンテンツ（取得、スクレイピング、閲覧、イシュー、フィード）
2. 機密データ／個人データ（ボルト、DB、シークレット、KVKK の規制対象となる個人情報）
3. 外部への流出または破壊（送信、Webhook、エクスポート、削除、ドロップ）

1 つの MCP サーバーがこの 3 つすべてを公開している場合、1 回のプロンプトインジェクションでこれらを連鎖させることができます。主に OWASP MCP10:2025 に対応しています。

テレメトリはデフォルトでオフです。GUARDBEE_TELEMETRY=1 を設定すると、サーバー、ツール、成功状況、所要時間、ファイルパスなどの短いパラメーター値が送信されます。長い文字列や content、token、password などのフィールドはプレースホルダーに置き換えられます。詳しくは @guardbee/mcp-telemetry をご覧ください。

Claude ──► toxic-flow-auditor ──► tools/list JSON or MCP server source
              │
              ├─ lethal_trifecta      (untrusted + sensitive + outbound)
              ├─ single_tool_trifecta (one tool alone spans all three)
              ├─ sensitive_plus_exfil
              ├─ untrusted_plus_exfil
              └─ sensitive_plus_destruct

検出対象

• カタログ全体にわたる致命的な三要素。 信頼できないコンテンツを取得し、ボルト／DB／個人情報にアクセスし、データの外部送信または破壊が可能なツールが同一サーバーに存在する場合に検出します。
• 単一ツールの三要素。 1 つの登録の名前／説明だけで、3 つすべての機能を含んでいる場合に検出します。
• 危険な組み合わせ。 三要素すべてがそろっていなくても、機密情報と外部流出、信頼できない情報と外部流出、または機密情報と破壊の組み合わせを検出します。
• KVKK 対応ヒューリスティック。 トルコの個人情報を示すシグナル（tc_kimlik、müşteri、KVKK）は、機密データとして扱われます。
• snake_case の名前を単語ごとに判定。 read_vault_secret や drop_table は各単語に分けて分類します。プルリクエストの作成は外部流出として扱われます。

評価は A～F です。API キーは不要です。静的／カタログ分析のみを行い、実際のツールは呼び出しません。

分類ルールは @guardbee/guard-core に由来します。@guardbee/mcp-security-proxy は実行時に有害なフローをブロックするため、同じルールを使用します。

ツール

ツール	用途
audit_catalog	tools/list 形式の JSON ダンプを監査します
scan_source	ソーステキストから .tool(...) の登録を抽出します
scan_file	ソースファイルを 1 つスキャンします
scan_directory	再帰的にスキャンし、複数のファイルにあるツールを統合します
explain_trifecta	モデルについて説明します

CLI

npx @guardbee/mcp-toxic-flow-auditor audit <tools.json> [--fail-on=any] [--format=text|json|sarif]
npx @guardbee/mcp-toxic-flow-auditor scan <path>        [--fail-on=any] [--format=text|json|sarif]

カタログの例：

{
  "tools": [
    { "name": "fetch_page", "description": "Scrape a URL" },
    { "name": "read_vault_secret", "description": "Read API key from vault" },
    { "name": "send_slack_message", "description": "Post to webhook" }
  ]
}

フィードバック

質問やアイデア、誤検知がありましたら、GitHub Discussions でスレッドを立てるか、イシューを作成してください。GuardBee が役に立った場合は、リポジトリに ⭐ を付けていただくと、ほかの人にも見つけてもらいやすくなります。