nuclei-mcp

MCP-сервер Nuclei с ограничением области действия, который отказывается сканировать всё, что не найдено в ваших снимках области действия HackerOne. Работает как дополнение к 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)

Два контейнера используют один и тот же хост-каталог, смонтированный как том. h1-scope-watcher поддерживает JSON-файлы в актуальном состоянии; nuclei-mcp только считывает их.

Related MCP server: shodan-mcp

Шлюз области действия — Как это работает

Каждый вызов nuclei_scan или check_scope выполняет эту логику перед обращением к сети:

1. Загрузка всех файлов *.json из /data/snapshots

2. Попытка точного совпадения имени хоста (например, api.life360.com → совпадает с api.life360.com)

3. Попытка совпадения по шаблону (wildcard) (например, 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. Добавление в конфигурацию MCP Claude/Copilot

Откройте 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 является документом, подтверждающим авторизацию.