DugganUSA CLI — Local STDIO MCP

dugganusa-cli

ドキュメント： https://docs.dugganusa.com/quickstart/

あなたはあなたらしく。私は私らしく。コンテキストを共有します。

ターミナルとエージェントはそれぞれ独自のコンテキストを保持します。DugganUSA Feed は、あなたが所有するバイナリから、そのコンテキストを読み取り専用で提供します。

2 つのバイナリ。1 回のインストール。確認できる脅威インテリジェンス。 コーパスのサイズ：最新の件数。

新着情報（v1.5.1）

• サプライチェーンのスキャンが強化されました。 コーパスは、OSV の悪意のあるパッケージフィードを npm と PyPI の両方 について取り込むようになりました。名前が特定された悪意のあるパッケージを、ヒューリスティックを使わず、毎日取り込みます。これに加え、マルウェアを配置するリポジトリや、インストール時の実行シグネチャを毎日の GitHub Hunt で検出します。ロックファイルをパイプで渡すか、--file package.json を指定すると、既知の危険なパッケージがネットワーク IOC と並んで表示されます。これは CI での利用を想定した機能です。汚染された依存関係がリリースされる前に検出できます。
• 認証不要で常時稼働し、デプロイ後も利用できる 4 つの検証エンドポイント により、フィードの品質を確認できます。
  • 新規性 — feed-uniqueness：私たちも収録し、クレジットを表示している ThreatFox と比べて、公開データのどれだけが新たな情報を加えているかを、リアルタイムで測定します。
  • 適時性 — kev-lead：悪用された CVE が CISA KEV と比べていつコーパスに追加されたかを、同日追加や記録なしの場合も含めて確認できます。
  • 正確性 — spamhaus-validation：Spamhaus が、私たち自身の調査による提供情報を独立して検証します。
  • 稼働状況 — feed-efficacy：実際のトラフィックで指標が検知されたタイミングについて、オプトインした利用者から報告を受け付けます。これにより、フィードが単に大規模なだけでなく、運用上も稼働していることを確認できます。

# Scanner — block bad IOCs in your stack
npx dugganusa-cli 185.39.19.176

# MCP server — wire DugganUSA into Claude Desktop / Cursor / Claude Code
npx -y -p dugganusa-cli dugganusa-mcp

ミネソタ州の 2 人で運営する LLC です。コーパスの大半は、abuse.ch、Spamhaus、CISA、OSV、そして名前を挙げて引用している研究者の方々による優れた取り組みから成り立っています。私たちはそこに独自の GitHub 調査とエッジセンサーのデータを加えて相関分析し、情報源を添えて提供しています。

あなたに求めるもの： 読めないものを求めることはありません。エージェントのインストールは不要で、インバウンドアクセスもなく、検索する指標以外のデータがマシンの外に出ることもありません。今使っているツールはすべてそのまま使えます。それらに加えて、別の視点を提供します。

バイナリ名の変更（v1.3.0 以降）： スキャナーバイナリは v1.2.0 では dugganusa-lookup でしたが、現在は dugganusa-cli です。古い dugganusa-lookup パッケージは廃止されています。dugganusa-cli を使用してください。MCP バイナリ（dugganusa-mcp）に変更はありません。固定しているスクリプトを更新してください。

インストール

# Run without installing
npx dugganusa-cli 185.39.19.176
npx -y -p dugganusa-cli dugganusa-mcp --help

# Or install globally — both bins on PATH
npm install -g dugganusa-cli

スキャナーの使い方

# Single lookup
dugganusa-cli 185.39.19.176
dugganusa-cli welcome.supp0v3.com
dugganusa-cli CVE-2026-21643

# Multiple indicators
dugganusa-cli 185.39.19.176 welcome.supp0v3.com CVE-2026-21643

# Scan a file for IOCs
dugganusa-cli --file config.js
dugganusa-cli --file terraform/main.tf

# Pipe stdin (works with any tool)
cat firewall.log | dugganusa-cli --stdin
grep -r "http" src/ | dugganusa-cli --stdin

# Batch lookup (one IOC per line)
dugganusa-cli --batch iocs.txt

# AIPM audit (AI presence + brand exposure)
dugganusa-cli --aipm crowdstrike.com

# Output formats
dugganusa-cli --format json 185.39.19.176
dugganusa-cli --format markdown --file report.md
dugganusa-cli --format table 185.39.19.176  # default

# Only show matches (suppress clean results)
dugganusa-cli --file app.js --quiet

# With API key (higher rate limits)
dugganusa-cli --key dugusa_YOUR_KEY 185.39.19.176
# Or set env var
export DUGGANUSA_API_KEY=dugusa_YOUR_KEY

出力

  !!    12  185.39.19.176                                 IOC: Cobalt Strike C2 (via SSLBL) | Blocked 47x | 12 cross-index hits
  OK     0  8.8.8.8                                       clean

  1 threat indicator(s) found in 2 checked.
  Full enrichment: https://analytics.dugganusa.com/api/v1/search/correlate?q=<indicator>
  Free API key: https://analytics.dugganusa.com/stix/register

完全なエンリッチメント（相関分析）へのリンクにはキーが必要です（無料キーを取得してください）。

終了コード

コード	意味
0	すべて問題ありません — すべての指標を確認し、該当するものは見つかりませんでした
1	脅威指標が見つかりました — CI でビルドを失敗させる場合に使用してください
2	確認できなかった指標があります（キーの未設定／無効 → 401、1 日あたりの上限超過 → 429、ネットワークエラー）。UNKNOWN として報告され、問題なしとは判定されません

一致した場合に終了コード 1 を返すことが、この機能の目的です。既知の危険な指標を含むデプロイは、リリース前にブロックしてください。

CI/CD の例

# GitHub Actions — block deploys containing live IOCs
- name: Scan for threat indicators
  run: npx dugganusa-cli --file config/production.json --quiet

# Shell pipeline
if npx dugganusa-cli --file deploy.conf --quiet; then
  echo "Clean — deploying"
  ./deploy.sh
else
  echo "BLOCKED — threat indicators found"
  exit 1
fi

API キー

STIX フィードには API キーが必要です。匿名リクエストと未登録のキーには 401 が返され、登録済みのキーが 1 日あたりの上限を超えた場合は 429 が返されます。無料プランでも無料の 登録済み キーが必要 で、匿名では利用できません。こちらから登録してください：analytics.dugganusa.com/stix/register

無料プラン：1 日あたり 10 件のクエリ（料金）。--key フラグまたは DUGGANUSA_API_KEY 環境変数でキーを設定してください。

インデックスの内容

外部フィード（abuse.ch SSLBL、URLhaus、Spamhaus、CISA KEV、npm と PyPI の OSV 悪意のあるパッケージフィードなど）を情報源とする指標に加え、DugganUSA 独自の調査、エクスプロイト収集ツール、毎日の GitHub Hunt による検出結果、エッジハニーポットを収録しています。コーパス全体を横断して相関分析します（最新の件数）。

同じコーパスを、あなたのターミナルで。

---

MCP サーバー（dugganusa-mcp）

ローカルの STDIO MCP サーバーです。任意の MCP クライアントに接続すると、AI アシスタントが DugganUSA の脅威インテリジェンスコーパスを読み取り専用ツールとして利用できます。

エンドツーエンドで読める小規模な MCP サーバーなので、エージェントに追加する際に必要な信頼はごくわずかです。

ツールは3つだけ

• search — IOC、ブログ、攻撃者、CISA KEV など、コーパス全体を全文検索します（最新の件数）。
• enrich-ioc — IP のエンリッチメント：国、ASN、脅威の種類、マルウェアファミリー、インデックス間の相関情報を取得します。
• stix-feed-summary — インデックスの統計情報と、STIX 2.1 / TAXII 2.1 フィードへのポインターを表示します。

書き込みを行うツールはありません。ファイルシステムにアクセスするツールもありません。コマンドを実行するツールもありません。どこまでも読み取り専用です。

Claude Desktop に接続する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）に追加します。

{
  "mcpServers": {
    "dugganusa": {
      "command": "npx",
      "args": ["-y", "-p", "dugganusa-cli", "dugganusa-mcp"],
      "env": {
        "DUGGANUSA_API_KEY": "your-registered-key"
      }
    }
  }
}

Claude Desktop を再起動してください。ピッカーに3つのツールが表示されます。同じ方法で、Cursor、Windsurf、Claude Code、または STDIO に対応する任意の MCP クライアントでも利用できます。

ローカルポリシーの適用：--dredd-gate

dugganusa-mcp --dredd-gate

すべてのツール呼び出しを事前チェックし、ツール名と必須引数を検証して、許可された呼び出しを stderr に記録します。mcp/lib/serve.js の判定関数（関数 dreddVerdict）を確認してください。ここに、拒否リスト、IP 許可リスト、ツールごとのレート制限、リモート dredd 判定エンドポイントなど、より厳格なポリシーを組み込めます。

デフォルトでは無効です。ノートパソコン以外の環境で使う場合は有効にしてください。

この MCP が存在する理由

STDIO MCP サーバーは、ユーザーの権限でユーザーのマシン上で動作します。そのため、私たちのものを含め、どのサーバーに対しても「どれほど信頼する必要があるか」を問うべきです。私たちは、その答えが「ごくわずか」になるように努めました。

• 読み取り専用のツールのみ — 書き込みも実行もありません
• サードパーティ製 MCP SDK への依存なし（すべてのコードはこのリポジトリ内にあります）
• バイナリはお客様が所有し、ローカルで実行するため、リクエストがマシンを離れる前にすべて確認できます
• オプションの --dredd-gate ローカルポリシーフック
• npm の実行時依存関係はゼロです

これが、この MCP です。

バイナリの監査

実行するバイト列を確認してください。

# install
npm install -g dugganusa-cli

# audit
grep -rnE 'child_process|require\(.*shell|require\(.*child|exec\(|spawn\(|eval\(' "$(npm root -g)/dugganusa-cli"

何も返らないはずです。

mcp/ 以下のソース構成：

• mcp/serve.js — bin エントリーポイント、argv パーサー（約45行）
• mcp/lib/serve.js — STDIO 経由の JSON-RPC 2.0（約125行）
• mcp/lib/tools.js — 3つのツールスキーマとハンドラー（約80行）
• mcp/lib/upstream.js — analytics.dugganusa.com への HTTPS リクエスト（約40行）

テスト：

npm run test:mcp

ディスパッチ部分と実際のネットワーク呼び出しを対象とした10件のテストがあります。すべてのリリースで、公開前に CI で実行されます。

来歴

v1.3.0 以降のリリースは、npm Trusted Publishing（GitHub Actions OIDC）を使い、--provenance を指定して公開されています。検証方法：

npm audit signatures dugganusa-cli

公開されたバイト列が、特定の GitHub ワークフロー実行における特定のコミットから生成されたことを示す、署名付きの証明が得られます。長期間有効なトークンは使用しません。

---

作業内容の確認

私たちは間違えることがあり、そのことを公に認めます。訂正には日付を付け、元の主張の隣に掲載しています（dugganusa.com）。すべての判定には根拠となった情報源が付いているため、私たちの言葉を鵜呑みにせず、その情報源と照らし合わせて確認できます。ここに誤りがあれば、イシューを作成してください。それが、皆さんから送っていただける最も役立つ情報です。

---

DugganUSA エコシステムの一部

• VS Code 拡張機能
• DugganUSA フィード
• AIPM — AI プレゼンス管理：AI があなたについて何を語っているか
• dugganusa.com — 調査、方法論、根拠資料

ライセンス

MIT — DugganUSA LLC、ミネソタ州。お問い合わせ先：[email protected]。

無料プランは本当に無料です。監査してください。フォークしてください。私たちの誤りを見つけたらお知らせください。

---

DugganUSA Defender ファミリー

どこで使っても、同じ DugganUSA Feed を利用できます。オープンソースで、MIT ライセンスを採用し、すべてのリポジトリに証跡があります。

プラグイン	対応先
dugganusa-scanner-core	コア IOC スキャンエンジン
dugganusa-vscode	VS Code 拡張機能
dugganusa-splunk	Splunk Technology Add-on
dugganusa-slack	Slack ボット
dugganusa-raycast	Raycast 拡張機能
dugganusa-sentinel	Microsoft Sentinel TAXII コネクター
dugganusa-obsidian	Obsidian プラグイン
dugganusa-nvim	Neovim プラグイン
dugganusa-elastic	Elastic / OpenSearch 統合
dugganusa-edge-shield	Cloudflare Worker
dugganusa-cli (このリポジトリ)	CLI スキャナー + ローカル STDIO MCP サーバー
dugganusa-chrome	Chrome 拡張機能
dugganusa-action	GitHub Action
dredd-mcp	事前チェック用 MCP セキュリティ判定ツール

DugganUSA Feed によって支えられています。数値はリアルタイムで更新されます：/api/v1/search/stats。料金：analytics.dugganusa.com/pricing。お問い合わせ：[email protected]。

確認できる脅威インテリジェンス。