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)

두 컨테이너는 볼륨으로 마운트된 동일한 호스트 디렉토리를 공유합니다. h1-scope-watcher는 JSON 파일을 최신 상태로 유지하고, nuclei-mcp는 이를 읽기만 합니다.

Related MCP server: shodan-mcp

범위 게이트(Scope Gate) — 작동 방식

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 AND 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 프로그램 계약서가 곧 권한 부여 문서입니다.