nuclei-mcp

HackerOneスコープスナップショットに含まれていないものは一切スキャンしない、スコープ付きNuclei MCPサーバーです。h1-scope-watcherのコンパニオンとして機能します。

アーキテクチャ

Copilot/Claude (AI agent)
    │
    │  MCP (stdio)
    ▼
nuclei-mcp container
    │  reads scope
    ├──────────────────► /data/snapshots/*.json  ◄─── h1-scope-watcher writes here
    │  runs scan
    └──────────────────► nuclei binary (built-in)

2つのコンテナは、ボリュームとしてマウントされた同じホストディレクトリを共有します。 h1-scope-watcherがJSONファイルを最新の状態に保ち、nuclei-mcpはそれらを読み取るだけです。

Related MCP server: shodan-mcp

スコープゲート — 仕組み

nuclei_scanまたはcheck_scopeへのすべての呼び出しは、ネットワークに触れる前に以下のロジックを実行します：

1. /data/snapshotsからすべての*.jsonファイルを読み込む

2. ホスト名の完全一致を試行する（例: api.life360.com → api.life360.comに一致）

3. ワイルドカード一致を試行する（例: sub.tile.com → *.tile.comに一致）

4. 曖昧キーワード一致を試行する（例: life360 → api.life360.com、api-cloudfront.life360.comを見つける）

5. eligible_for_bounty == true かつ eligible_for_submission == true であるかを確認する

6. いずれかのチェックに失敗した場合はブロックする — 例外やオーバーライドは不可

クイックスタート

1. イメージのビルド

cd nuclei-mcp
docker build -t nuclei-mcp .

2. Claude/Copilot MCP設定への追加

claude_desktop_config.json（または同等のもの）やmcp-config.json（copilot）を開き、以下を追加します：

{
  "mcpServers": {
    "h1-scope-watcher": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "mcp/h1-scope"
      ]
    },
    "nuclei-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "nuclei-mcp"
      ]
    }
  }
}

重要なポイント: 両方のコンテナは全く同じホストパス（D:/projects/H1-Scope-Watcher/snapshots）をマウントしているため、追加のネットワークやIPCなしでスコープデータを共有できます。

H1-Scope-Watcher

MCPツール

nuclei_scan

Nucleiスキャンを実行します（スコープ制限あり）。

プロンプト例:

• "Run nuclei on life360"

• "Scan api.tile.com for critical and high findings"

• "Run nuclei on production.tile-api.com with cve templates only"

check_scope

スキャンせずにスコープゲートの結果をプレビューします。

プロンプト例:

• "Is tile.com in scope?"

• "Check if snipeit.corp.tile.com is bounty eligible" → BLOCKEDと表示されます

list_programs

すべてのスナップショットファイルからすべての資産を表示し、適格性ごとにグループ化します。

環境変数

スコープ動作リファレンス

tile.comプログラムの例から：

法的注意

自身が所有している、またはテストに対する明示的な書面による許可を得ているターゲットのみをスキャンしてください。 このツールは権限を付与するものではありません。HackerOneプログラムの合意書が権限の根拠となる文書です。