
PAS à des fins éducatives : Un serveur MCP pour les testeurs d'intrusion professionnels, incluant la prise en charge de STDIO/HTTP/SSE, nmap, go/dirbuster, nikto, JtR, hashcat, la création de wordlists, et plus encore.
Pentest MCP est un serveur MCP en TypeScript destiné aux évaluations de sécurité autorisées. Il offre à un chercheur humain ou à un agent d'évaluation utilisant des outils une interface unique et délimitée pour la découverte, la validation, la capture, la vérification des identifiants, l'audit local, la récupération de preuves et la préparation de rapports. Chaque appel d'outil actif est rattaché à un engagement et à un enregistrement durable. Le serveur vérifie les cibles déclarées et la fenêtre temporelle ; le chercheur valide les conclusions avant publication.
engagementId stable.allowedToolNames du plan n'autorise que les appels sélectionnés. Les outils actifs passent également le contrôle de la cible et de la fenêtre temporelle de l'engagement.recordId et les décisions de périmètre corrélées avec listEngagementRecords et getEngagementRecord. Les enregistrements persistent entre les redémarrages. Importez des recherches externes avec recordResearchActivity ; l'import ne remplace pas l'utilisation des outils MCP.getClientReport.La vérification des cibles déclarées est un garde-fou opérationnel, et non une frontière réseau complète. Les changements DNS, les redirections, les scripts Nmap, les modèles Nuclei et le comportement d'autres outils tiers peuvent générer du trafic secondaire. Examinez la configuration des outils et maintenez les contrôles réseau alignés sur les règles de l'engagement.
L'étape d'évaluation est une session d'agent utilisant des outils. runAgentAssessment prend en charge Codex ou Claude local dans un profil de compte dédié, Codex dans un conteneur épinglé, un serveur compatible OpenAI en boucle locale tel que llama.cpp ou Ollama, ainsi qu'OpenRouter. Les workers CLI reçoivent un serveur Pentest MCP verrouillé, limité à un seul engagement, et découvrent le catalogue complet. Les modèles API protégés ne reçoivent que la liste d'autorisation exacte du plan, croisée avec le catalogue du worker. Chaque action demandée passe toujours par les mêmes contrôles côté worker (plan, cible, statut parent et fenêtre temporelle) avant le démarrage d'un gestionnaire. L'option hostileModelProtection ajoute des disjoncteurs pour les actions en double, la comptabilisation des jetons et les motifs de fin, et vaut false par défaut. Une exécution interrompue avec un reçu de démarrage durable et sans reçu terminal bloque la relecture ; reconcileAgentAssessment exige qu'un opérateur confirme l'arrêt du processus précédent, enregistre le réviseur et la justification, et révoque le périmètre du worker précédent lorsqu'il est encore disponible. Les valeurs retournées toolCounts, importedRecordIds et importMapRecordId identifient les actions enregistrées et les preuves importées. Une exécution sans appel réussi à un outil d'évaluation échoue.
draftAssessmentReport est une étape ultérieure de rédaction de rapport, mise en quarantaine du contexte ; un simple brouillon ne démontre pas que Pentest MCP a contribué à l'évaluation. OpenAI, Anthropic, OpenRouter, les services compatibles OpenAI, Codex local, Claude local, Codex en conteneur et les profils SSH configurés peuvent rédiger à partir d'un paquet de preuves délimité sans outils de scan. local-agent accepte les profils CLI auto-hébergés et les profils compatibles OpenAI en boucle locale tout en rejetant les fournisseurs hébergés avant l'envoi du contexte. Le guide des modèles protégés fournit les profils llama.cpp et OpenRouter, les conditions d'arrêt imposées, les champs d'audit et les limites de déploiement des modèles hostiles. Le guide d'évaluation en conteneur fournit les champs de profil CLI, la commande d'acceptation réelle et les limites d'isolation. Le workflow agentique couvre le périmètre, la revue des preuves, l'accès Daybreak/Glasswing et la planification Faxbot.
L'acceptation de version utilise scripts/run-real-acceptance.mjs. Il n'a ni cible ni autorisation par défaut et refuse de réussir à moins que Nmap et ProjectDiscovery HTTPX installés ne créent des enregistrements de preuves réussis. Avec --profile, l'agent géré doit invoquer les deux via Pentest MCP. Avec --report-profile, un contexte de rapport distinct doit produire le brouillon enregistré. Les doublures de test restent uniquement dans les tests automatisés et ne sont jamais livrées comme reçus d'acceptation.
Nécessite Node.js 22.19.0 ou une version plus récente ainsi que les binaires hôtes des outils que vous comptez utiliser. L'image Docker inclut les outils listés ; les installations natives doivent les fournir dans le PATH.
npm install -g pentest-mcp
pentest-mcp
Stdio est le mode par défaut pour les clients MCP locaux. pentest-mcp inspector lance l'Inspector MCP intégré contre ce serveur via stdio ; les options de l'Inspector peuvent être transmises, par exemple pentest-mcp inspector --help.
Définissez PENTEST_DATA_DIR pour choisir le répertoire local des preuves. Sinon, le serveur utilise $XDG_DATA_HOME/pentest-mcp lorsque cette variable est définie, ou ~/.pentest-mcp. Les fichiers de preuves et de rapports sont stockés avec des permissions privées de répertoire et de fichier. Traitez les sorties brutes, les hachages, le trafic capturé et les rapports comme des données sensibles pour le client ; contrôlez en conséquence les accès, la rétention et les sauvegardes.
Appelez createEngagement avant de lancer un scan. Utilisez les dates, cibles et références issues de l'autorisation signée réelle ; les valeurs ci-dessous sont illustratives.
{
"tool": "createEngagement",
"arguments": {
"engagementId": "client-2026-10",
"authorizationReference": "Signed SoW section 4, approved 2026-10-24",
"notBefore": "2026-10-25T09:00:00-06:00",
"expiresAt": "2026-10-26T18:00:00-06:00",
"allowedTargets": ["app.example.com", "192.0.2.0/28"],
"excludedTargets": ["192.0.2.7"],
"testingWindows": [
{
"start": "2026-10-25T09:00:00-06:00",
"end": "2026-10-25T17:00:00-06:00"
}
]
}
}