security-suite

@guardbee/security-suite

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

GuardBee のすべての MCP セキュリティツールを、1 回のインストールで利用できます。guardbee serve は、選択したパッケージのツールをまとめた 1 つの MCP サーバーを起動します。guardbee <package> … は、任意のパッケージの CLI を実行します。30 パッケージ、127 個の MCP ツールを利用できます。

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

クイックスタート

{
  "mcpServers": {
    "guardbee": {
      "command": "npx",
      "args": ["-y", "@guardbee/security-suite", "serve"]
    }
  }
}

これにより、推奨セット（31 個のツール）が起動します。このセットには、OWASP MCP Top 10 のワンパススキャン、シークレット、プロンプトインジェクション、トキシックフロー、MCP クライアント設定、依存関係の CVE が含まれます。--tools で別のツールを選択できます。

"args": ["-y", "@guardbee/security-suite", "serve", "--tools=recommended,network"]

--tools にはグループ名とパッケージ ID をカンマ区切りで指定するか、all を指定します（127 個のツール。一部のクライアントではツール数に上限があり、Cursor もその 1 つです）。環境変数 GUARDBEE_SUITE_TOOLS でも同じ指定ができます。各ツール名にはパッケージのプレフィックスが付くため、異なるパッケージの scan_text ツールが衝突することはありません。たとえば、secrets_scan_text、injection_scan_text のようになります。もともと用途が明確な名前はそのままです（owasp_scan_path、inspect_ssl）。

グループ

グループ	対象
recommended（デフォルト）	owasp-scan、secret-scanner、prompt-injection-scanner、toxic-flow-auditor、mcp-config-auditor、dependency-auditor
code	ディスク上のソースコード、設定、コンテンツの静的チェック
supply-chain	依存関係、幻覚によるパッケージ、モデルファイル、MCP クライアント設定、ツール定義の不整合
network	ホストに接続して行うチェック：TLS、DNS、ベクトルストア、稼働中の LLM
platform	GuardBee プラットフォームを呼び出すツール（GUARDBEE_API_KEY が必要）
all	すべてのパッケージ

パッケージ

ID	ツールのプレフィックス	チェック項目	グループ
owasp-scan	owasp_	コードベースまたは稼働中のサーバーを一度スキャンして、OWASP MCP Top 10をチェックし、A～Fで評価	recommended, code
secret-scanner	secrets_	ファイル、Git履歴、エージェントのトランスクリプト内のAPIキー、トークン、パスワード	recommended, code
prompt-injection-scanner	injection_	ドキュメント、ウェブページ、RAGコンテンツ内のプロンプトインジェクション	recommended, code
toxic-flow-auditor	toxic_flow_	致命的な三要素：1つのエージェントにおける信頼できない入力、機密データ、外部への送信	recommended, code
mcp-config-auditor	mcp_config_	MCPクライアントの設定（Cursor、Claude、Windsurf、VS Code）とシャドウサーバー	recommended, supply-chain
dependency-auditor	deps_	npmおよびPyPIの依存関係に含まれる既知のCVE（OSV）	recommended, supply-chain
prompt-leak-scanner	leak_	アプリから外部へ送信される前の、LLMプロンプト内の認証情報とPII	code
tool-poisoning-scanner	poisoning_	MCPツールの説明とスキーマ内に隠された指示	code
mcp-server-auditor	server_audit_	MCPサーバーのソース内のシェル、eval、SSRF、シークレット	code
oauth-auditor	oauth_	MCPサーバーの認証コードにおけるOAuth 2.1の誤り：トークンのパススルー、audience、PKCE	code
audit-gap-auditor	audit_gap_	監査証跡のないツール呼び出し（OWASP MCP08）	code
context-oversharing-auditor	oversharing_	コンテキストの過剰共有（MCP10）：セッションダンプ、ユーザー間のコンテキスト共有、スコープが限定されていない情報の再取得	code
ai-code-scanner	ai_code_	安全でないLLM連携：キーの露出、安全でないモデル出力、サードパーティのLLMへのPII送信	code
agent-graph-auditor	agent_graph_	LangGraph、CrewAI、AutoGenエージェント間で連鎖する過剰な権限	code
a2a-auditor	a2a_	Agent2Agent（A2A）の実装コード：WebhookのSSRF、認証されていないAgent Card	code
elicitation-auditor	elicitation_	ユーザーにシークレットを尋ねたり、第三者に送信したりするMCPエリシテーション	code
memory-poisoning-scanner	memory_	信頼できない入力の永続的なエージェントメモリへの書き込み	code
unbounded-consumption-auditor	consumption_	ウォレット枯渇攻撃：トークン制限、タイムアウト、ループ上限の欠如	code
threat-rules	threat_rules_	テキスト、ファイル、エージェントイベントに対するAgent Threat Rules（ATR）	code
document-scanner	document_	LLMに渡される前のPDFや画像内のPIIと認証情報（OCR）	code
reverse-shield	reverse_	リリース済みアプリのリバースエンジニアリングの容易さ：ソースマップ、難読化、デバッグ情報、Electronのフューズ、APKフラグ	code
slopsquat-scanner	slopsquat_	幻覚によって生成された名前や新規のパッケージ名（スロップスクワッティング）	supply-chain
model-scanner	model_	悪意のあるpickle、safetensors、Keras、ONNXのモデルファイル	supply-chain
rug-pull-detector	rug_pull_	承認後に変更されるMCPツール定義	supply-chain
ssl-inspector	ssl_	TLS証明書、暗号スイート、HSTS	network
dns-intelligence	dns_	DNSレコード、SPF/DMARC/DKIM、サブドメイン乗っ取り	network
vector-store-scanner	vector_store_	認証されていないベクトルデータベース（Weaviate、Qdrant、Chroma、pgvector…）	network
llm-redteam	redteam_	自分が管理するLLMエンドポイントに対する、ジェイルブレイクおよび情報抽出のプローブ	network
vulnerability-scanner	vuln_	GuardBeeプラットフォームのセキュリティスキャンとその検出結果	platform
compliance-checker	compliance_	GuardBee APIを使用した、ウェブサイトのKVKK、GDPR、CCPAへの準拠状況	platform

guardbee list はこの表を出力します。プロキシ（mcp-security-proxy）とデータベースゲートウェイ（mcp-db-gateway）は、ツール呼び出しに応答するのではなく、他のサーバーの前段に配置されるため、このスイートには含まれていません。

CLI

npm install -g @guardbee/security-suite

guardbee list                                         # packages and groups
guardbee owasp-scan scan . --fail-on=high --format=sarif > owasp.sarif
guardbee secret-scanner scan . --history              # any package's CLI, same arguments
guardbee mcp-config-auditor discover

以前のバージョンのショートカットも引き続き使用できます。

ショートカット	実行内容
guardbee secret-scan <path>	secret-scanner scan
guardbee dep-audit <dir>	dependency-auditor audit
guardbee ssl-inspect <domain>…	ssl-inspector inspect
guardbee dns-check <domain>	dns-intelligence check

GitHub Actions

- run: npx -y @guardbee/security-suite owasp-scan scan . --format=sarif --fail-on=high > owasp.sarif
- run: npx -y @guardbee/security-suite dep-audit . --fail-on=high
- uses: github/codeql-action/upload-sarif@v3
  if: always()
  with:
    sarif_file: owasp.sarif

0.2 からのアップグレード

以前は、guardbee serve を実行すると、4 つのパッケージから 5 つのツールが、プレフィックスのない名前（scan_directory、scan_file、audit_dependencies、inspect_ssl、check_dns）で公開されていました。現在は、プレフィックス付きの名前で推奨グループを提供します。同じチェックには、secrets_scan_directory、secrets_scan_file、deps_audit_directory という名前が付けられています。また、--tools=recommended,network を指定すると、inspect_ssl と enumerate_dns / dns_check_email_security が使用できます。名前を指定してツールを呼び出すエージェントでは、新しい名前が必要です。

ライセンス

MIT — GuardBee

フィードバック

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