Pentest MCP

Server MCP professionale per penetration test con supporto moderno per trasporto/autenticazione e strumentazione di ricognizione ampliata.

Novità nella versione 0.9.0

• SDK MCP aggiornato a @modelcontextprotocol/sdk@^1.26.0
• MCP Inspector mantenuto all'ultima release (@modelcontextprotocol/inspector@^0.20.0) con launcher integrato
• Streamable HTTP è ora il trasporto di rete primario (MCP_TRANSPORT=http)
• SSE è ancora disponibile solo come modalità di compatibilità deprecata
• Aggiunta autenticazione bearer token con supporto OIDC JWKS e introspection
• Aggiunti strumenti di prima classe: subfinderEnum, httpxProbe, ffufScan, nucleiScan, trafficCapture, hydraBruteforce, privEscAudit, extractionSweep
• Aggiunti strumenti di amministrazione dei report: listEngagementRecords, getEngagementRecord
• Aggiunto flusso di acquisizione della SoW per i report tramite elicitazione MCP (scopeMode=ask) con fallback su modello sicuro
• Indurita la risoluzione dei comandi affinché il probing web usi httpx-toolkit (preferito) o ProjectDiscovery httpx validato, evitando collisioni con la CLI Python httpx
• Integrato il launcher MCP Inspector incluso (pentest-mcp inspector)
• La baseline runtime è ora Node.js 22.7.5+
• Aggiunti metadati di invocazione nei nuovi output degli strumenti quando è disponibile il contesto di autenticazione/sessione

Strumenti inclusi

• nmapScan
• runJohnTheRipper
• runHashcat
• gobuster
• nikto
• subfinderEnum
• httpxProbe
• ffufScan
• nucleiScan
• trafficCapture
• hydraBruteforce
• privEscAudit
• extractionSweep
• generateWordlist
• listEngagementRecords
• getEngagementRecord
• createClientReport
• cancelScan

Avvio rapido

Installazione

npm install -g pentest-mcp

Esecuzione locale (stdio)

pentest-mcp

Avvio di MCP Inspector integrato (nessuna installazione separata)

pentest-mcp inspector

Puoi inoltrare direttamente i flag di Inspector:

pentest-mcp inspector --help

Esecuzione in rete (Streamable HTTP)

MCP_TRANSPORT=http MCP_SERVER_HOST=0.0.0.0 MCP_SERVER_PORT=8000 pentest-mcp

Esecuzione in modalità SSE legacy (deprecata)

MCP_TRANSPORT=sse MCP_SERVER_PORT=8001 pentest-mcp

Note sul trasporto

• stdio: predefinito per i client MCP locali.
• http: trasporto di rete moderno. Consigliato.
• sse: solo per compatibilità. Deprecato e verrà rimosso in una futura major release.

Integrazione di Inspector

• pentest-mcp inspector avvia la CLI integrata @modelcontextprotocol/inspector.
• Punta automaticamente a questo server MCP tramite stdio lanciando:
  • node <this-package-entrypoint> stdio
• Non è necessario installare Inspector separatamente.

Configurazione dell'autenticazione (Bearer + OIDC)

Imposta queste variabili d'ambiente quando usi MCP_TRANSPORT=http (o sse se necessario):

MCP_AUTH_ENABLED=true
MCP_AUTH_MODE=bearer
MCP_AUTH_SCOPES=read,write
MCP_AUTH_AUDIENCE=
MCP_OIDC_ISSUER=https://issuer.example.com
MCP_OIDC_JWKS_URL=https://issuer.example.com/.well-known/jwks.json
# optional alternative/backup validation mode:
MCP_OIDC_INTROSPECTION_URL=https://issuer.example.com/oauth/introspect
MCP_OAUTH_CLIENT_ID=...
MCP_OAUTH_CLIENT_SECRET=...

Gli alias legacy sono ancora accettati temporaneamente:

• MCP_OAUTH_ENABLED
• MCP_OAUTH_PROVIDER_URL
• MCP_OAUTH_SCOPES

Flusso di lavoro e report

createClientReport ora supporta le modalità di gestione della SoW:

• scopeMode=ask: richiedi all'utente tramite elicitazione MCP (consigliato)
• scopeMode=provided: usa direttamente il valore scopeOfWork
• scopeMode=template: usa il modello generico integrato per test autorizzati

Se l'elicitazione viene rifiutata o non è disponibile, il report ripiega automaticamente sul modello.

Come gli utenti forniscono la SoW (al momento)

Non esiste ancora un'API separata per il caricamento di file. Le opzioni attuali sono:

1. Chiedi in modo interattivo tramite l'invocazione utente MCP (elicitazione)

{
  "tool": "createClientReport",
  "arguments": {
    "title": "Q1 External Pentest",
    "assessmentType": "external-network",
    "scopeMode": "ask"
  }
}

2. Incolla il testo della SoW direttamente in scopeOfWork

{
  "tool": "createClientReport",
  "arguments": {
    "title": "Q1 External Pentest",
    "assessmentType": "external-network",
    "scopeMode": "provided",
    "scopeOfWork": "Authorized targets: ...\nOut-of-scope: ...\nTesting window: ...\nRules of engagement: ..."
  }
}

3. Usa la modalità modello quando i dettagli del cliente non devono essere condivisi

{
  "tool": "createClientReport",
  "arguments": {
    "title": "Q1 External Pentest",
    "assessmentType": "external-network",
    "scopeMode": "template"
  }
}

Come questo riduce i tempi amministrativi

• Ogni esecuzione di uno strumento registra un record di engagement strutturato (recordId=...) con il contesto di invocazione.
• Usa listEngagementRecords per recuperare rapidamente tutti gli artefatti di lavoro.
• Genera il report dai recordIds selezionati (o di default dai record più recenti) invece di copia e incolla manuali.
• Le note sull'ambito vengono allegate automaticamente da una delle seguenti:
  • modulo di elicitazione utente (ask)
  • testo SoW incollato (provided)
  • modello predefinito sicuro (template)

Roadmap

Queste funzionalità sono pianificate specificamente per ridurre il sovraccarico amministrativo dei pentest.

• Ingestione di scopeFilePath (carica la SoW da un percorso file locale sull'host MCP)
• Flusso di caricamento a chunk di scopeDocument (invio del contenuto della SoW direttamente tramite MCP per i client remoti)
• Parser SoW che estrae automaticamente target, esclusioni, finestre di test e regole di ingaggio
• Collegamento automatico delle evidenze dagli output degli strumenti (recordId) ai finding e alle sezioni del report
• Deduplicazione/unione dei finding tra strumenti sovrapposti (nuclei, nikto, ecc.)
• Bozza automatica di severità e testo dell'impatto per write-up più rapidi
• Generazione del pacchetto report con un clic (sintesi esecutiva + appendice tecnica + tabella di remediation)
• Modalità diff per i retest (finding corretti/riaperti/nuovi tra engagement)
• Sincronizzazione dell'export dei ticket (Jira/Linear/GitHub) con backfill dello stato
• Controlli QA dei deliverable (evidenze mancanti, campi di ambito mancanti, note di remediation deboli)

Nota sull'adozione:

• Ci si aspetta un uso intenso di scopeFilePath e scopeDocument perché la maggior parte dei team mantiene già la SoW in documenti/PDF e vuole evitare passaggi ripetuti di copia e riformattazione.

Esempi di ricognizione e sfruttamento

Enumerazione dei sottodomini

{
  "tool": "subfinderEnum",
  "arguments": {
    "domain": "example.com",
    "recursive": true,
    "allSources": true
  }
}

Sonda gli host attivi

{
  "tool": "httpxProbe",
  "arguments": {
    "targets": ["example.com", "api.example.com"],
    "includeTitle": true,
    "includeStatusCode": true
  }
}

Fuzzing dei percorsi di contenuto

{
  "tool": "ffufScan",
  "arguments": {
    "targetUrl": "https://example.com/FUZZ",
    "wordlist": "/usr/share/seclists/Discovery/Web-Content/common.txt",
    "threads": 40
  }
}

Scansione con template

{
  "tool": "nucleiScan",
  "arguments": {
    "targets": ["https://example.com"],
    "severities": ["medium", "high", "critical"]
  }
}

Cattura del traffico (sniffing)