Pentest MCP

Serveur MCP professionnel de tests d'intrusion avec prise en charge moderne des transports/authentification et outillage de reconnaissance étendu.

Nouveautés de la version 0.9.0

• Mise à niveau du SDK MCP vers @modelcontextprotocol/sdk@^1.26.0
• MCP Inspector conservé à la dernière version (@modelcontextprotocol/inspector@^0.20.0) avec lanceur intégré
• HTTP streamable est désormais le transport réseau principal (MCP_TRANSPORT=http)
• SSE reste disponible uniquement en mode compatibilité déprécié
• Authentification par jeton bearer ajoutée avec prise en charge OIDC JWKS et introspection
• Outils de première classe ajoutés : subfinderEnum, httpxProbe, ffufScan, nucleiScan, trafficCapture, hydraBruteforce, privEscAudit, extractionSweep
• Outils d'administration des rapports ajoutés : listEngagementRecords, getEngagementRecord
• Flux de capture de la portée des travaux (SoW) pour les rapports via l'élicitation MCP (scopeMode=ask) avec repli sûr sur le modèle
• Résolution des commandes renforcée afin que le sondage web utilise httpx-toolkit (préférable) ou un httpx ProjectDiscovery validé, évitant les collisions avec l'interface CLI Python httpx
• Lanceur MCP Inspector intégré (pentest-mcp inspector)
• La version minimale requise du runtime est désormais Node.js 22.7.5+
• Métadonnées d'invocation ajoutées dans les nouvelles sorties d'outils lorsque le contexte d'authentification/session est disponible

Outils inclus

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

Démarrage rapide

Installation

npm install -g pentest-mcp

Exécution locale (stdio)

pentest-mcp

Lancer le MCP Inspector intégré (sans installation séparée)

pentest-mcp inspector

Vous pouvez transmettre directement les options d'Inspector :

pentest-mcp inspector --help

Exécution via le réseau (HTTP streamable)

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

Exécution en mode SSE hérité (déprécié)

MCP_TRANSPORT=sse MCP_SERVER_PORT=8001 pentest-mcp

Notes sur les transports

• stdio : par défaut pour les clients MCP locaux.
• http : transport réseau moderne. Recommandé.
• sse : compatibilité uniquement. Déprécié et sera supprimé dans une future version majeure.

Intégration d'Inspector

• pentest-mcp inspector lance l'interface CLI @modelcontextprotocol/inspector intégrée.
• Il cible automatiquement ce serveur MCP via stdio en lançant :
  • node <this-package-entrypoint> stdio
• Vous n'avez pas besoin d'installer Inspector séparément.

Configuration de l'authentification (Bearer + OIDC)

Définissez ces variables d'environnement lorsque vous utilisez MCP_TRANSPORT=http (ou sse si nécessaire) :

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=...

Les alias hérités sont encore acceptés temporairement :

• MCP_OAUTH_ENABLED
• MCP_OAUTH_PROVIDER_URL
• MCP_OAUTH_SCOPES

Flux de travail et rapports

createClientReport prend désormais en charge les modes de gestion de la portée des travaux (SoW) :

• scopeMode=ask : invite l'utilisateur via l'élicitation MCP (recommandé)
• scopeMode=provided : utilise directement la valeur scopeOfWork
• scopeMode=template : utilise le modèle générique intégré de tests autorisés

Si l'élicitation est refusée/indisponible, le rapport revient automatiquement au modèle.

Comment les utilisateurs fournissent la portée des travaux (pour le moment)

Il n'existe pas encore d'API distincte de téléversement de fichiers. Les options actuelles sont :

1. Demander de manière interactive via l'invocation utilisateur MCP (élicitation)

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

2. Coller le texte de la portée des travaux directement dans 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. Utiliser le mode modèle lorsque les détails du client ne doivent pas être partagés

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

Comment cela réduit le temps d'administration

• Chaque exécution d'outil stocke un enregistrement d'intervention structuré (recordId=...) avec le contexte d'invocation.
• Utilisez listEngagementRecords pour récupérer rapidement tous les artefacts de travail.
• Générez le rapport à partir des recordIds sélectionnés (ou des enregistrements les plus récents par défaut) au lieu d'un copier-coller manuel.
• Les notes de portée sont attachées automatiquement à partir de l'un des éléments suivants :
  • formulaire d'élicitation utilisateur (ask)
  • texte de la portée des travaux collé (provided)
  • modèle par défaut sûr (template)

Feuille de route

Ces éléments sont prévus spécifiquement pour réduire la charge administrative des tests d'intrusion.

• Ingestion de scopeFilePath (chargement de la portée des travaux depuis un chemin de fichier local sur l'hôte MCP)
• Flux de téléversement par blocs de scopeDocument (envoi du contenu de la portée des travaux directement via MCP pour les clients distants)
• Analyseur de portée des travaux qui extrait automatiquement les cibles, exclusions, fenêtres de test et règles d'engagement
• Liaison automatique des preuves des sorties d'outils (recordId) aux constats et sections du rapport
• Déduplication/fusion des constats entre les outils qui se chevauchent (nuclei, nikto, etc.)
• Brouillon automatique de sévérité et d'impact pour des comptes rendus plus rapides
• Génération en un clic du pack de rapport (résumé exécutif + annexe technique + tableau de remédiation)
• Mode de comparaison des retests (constats corrigés/réouverts/nouveaux entre les interventions)
• Synchronisation de l'export des tickets (Jira/Linear/GitHub) avec mise à jour rétroactive des statuts
• Contrôles qualité des livrables (preuves manquantes, champs de portée manquants, notes de remédiation faibles)

Note d'adoption :

• Une utilisation importante est attendue pour scopeFilePath et scopeDocument, car la plupart des équipes gèrent déjà la portée des travaux dans des documents/PDF et souhaitent éviter les étapes répétées de collage et de reformatage.

Exemples de reconnaissance et d'exploitation

Énumération des sous-domaines

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

Sonder les hôtes actifs

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

Fuzzing des chemins de contenu