NÃO para fins educacionais: Um servidor MCP para testadores de penetração profissionais, incluindo suporte STDIO/HTTP/SSE, nmap, go/dirbuster, nikto, JtR, hashcat, construção de wordlists e mais.
O Pentest MCP é um servidor MCP em TypeScript para avaliações de segurança autorizadas. Ele oferece a um pesquisador humano ou a um agente de avaliação que utiliza ferramentas uma interface unificada e com escopo definido para descoberta, validação, captura, verificação de credenciais, auditoria local, recuperação de evidências e preparação de relatórios. Cada chamada de ferramenta ativa está vinculada a um engajamento e a um registro durável. O servidor verifica os alvos declarados e a janela de tempo; o pesquisador verifica os achados antes da publicação.
engagementId estável.allowedToolNames do plano permite apenas chamadas selecionadas. As ferramentas ativas também passam pela verificação de alvo e de janela de tempo do engajamento.recordId e as decisões de escopo correlacionadas com listEngagementRecords e getEngagementRecord. Os registros persistem entre reinicializações. Importe pesquisas externas com recordResearchActivity; a importação não substitui o uso das ferramentas MCP.getClientReport.A verificação de alvos declarados é uma proteção operacional, não uma fronteira de rede completa. Alterações de DNS, redirecionamentos, scripts do Nmap, templates do Nuclei e outros comportamentos de ferramentas de terceiros podem gerar tráfego secundário. Revise a configuração das ferramentas e mantenha os controles de rede alinhados com as regras do engajamento.
A etapa de avaliação é uma sessão de agente que utiliza ferramentas. runAgentAssessment oferece suporte a Codex ou Claude local em um perfil de conta dedicado, Codex em um contêiner fixado, um servidor compatível com OpenAI em loopback, como llama.cpp ou Ollama, e OpenRouter. Os workers de CLI recebem um servidor Pentest MCP bloqueado para um único engajamento e descobrem o catálogo completo. Os modelos de API protegidos recebem apenas a lista de permissões exata do plano, interseccionada com o catálogo do worker. Toda ação solicitada ainda passa pelas mesmas verificações de plano, alvo, status do processo pai e janela de tempo no lado do worker antes que um manipulador seja iniciado. O hostileModelProtection opcional adiciona disjuntores para ações duplicadas, contabilização de tokens e motivo de conclusão, e tem como padrão false. Uma execução interrompida com um recibo de início durável e sem recibo de término bloqueia a repetição; reconcileAgentAssessment exige que um operador confirme que o processo anterior foi encerrado, registra o revisor e a justificativa, e revoga o escopo anterior do worker quando ele ainda estiver disponível. Os valores retornados toolCounts, importedRecordIds e importMapRecordId identificam as ações registradas e as evidências importadas. Uma execução sem nenhuma chamada bem-sucedida a uma ferramenta de avaliação falha.
draftAssessmentReport é uma etapa posterior de redação de relatório, com contexto isolado; um rascunho por si só não demonstra que o Pentest MCP ajudou na avaliação. OpenAI, Anthropic, OpenRouter, compatíveis com OpenAI, Codex local, Claude local, Codex em contêiner e perfis SSH configurados podem redigir a partir de um pacote de evidências delimitado sem ferramentas de scanner. local-agent aceita perfis CLI auto-hospedados e perfis compatíveis com OpenAI em loopback, rejeitando provedores hospedados antes que o contexto seja enviado. O guia de modelos protegidos fornece perfis llama.cpp e OpenRouter, condições de parada aplicadas, campos de auditoria e limites de implantação para modelos hostis. O guia de avaliação em contêiner fornece campos de perfil CLI, comando de aceitação real e limites de isolamento. O fluxo de trabalho agêntico cobre escopo, revisão de evidências, acesso Daybreak/Glasswing e planejamento do Faxbot.
A aceitação de release usa scripts/run-real-acceptance.mjs. Ele não possui alvo ou autorização padrão e se recusa a passar a menos que o Nmap e o ProjectDiscovery HTTPX instalados criem registros de evidência bem-sucedidos. Com --profile, o agente gerenciado deve invocar ambos através do Pentest MCP. Com --report-profile, um contexto de relatório separado deve produzir o rascunho salvo. Dublês de teste permanecem apenas em testes automatizados e nunca são entregues como recibos de aceitação.
Requer Node.js 22.19.0 ou mais recente e os binários do host para as ferramentas que você pretende usar. A imagem Docker inclui as ferramentas listadas; instalações nativas devem fornecê-las no PATH.
npm install -g pentest-mcp
pentest-mcp
Stdio é o padrão para clientes MCP locais. pentest-mcp inspector inicia o MCP Inspector incluído contra este servidor via stdio; as flags do Inspector podem ser repassadas, por exemplo pentest-mcp inspector --help.
Defina PENTEST_DATA_DIR para escolher o diretório local de evidências. Caso contrário, o servidor usa $XDG_DATA_HOME/pentest-mcp quando essa variável está definida, ou ~/.pentest-mcp. Os arquivos de evidências e relatórios são armazenados com permissões privadas de diretório e arquivo. Trate saídas brutas, hashes, tráfego capturado e relatórios como dados sensíveis do cliente; controle o acesso, a retenção e os backups de acordo.
Chame createEngagement antes de escanear. Use datas, alvos e referências da autorização assinada real; os valores abaixo são ilustrativos.
{
"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"
}
]
}
}
Os alvos permitidos aceitam hosts exatos, CIDRs, subdomínios com wildcard e prefixos de URL HTTP(S). As exclusões têm precedência. Todos os timestamps precisam de um fuso horário explícito. getEngagement e listEngagements inspecionam os registros armazenados. closeEngagement revoga a execução posterior, aborta avaliações gerenciadas em execução no mesmo processo do servidor e faz com que um runner gerenciado separado pare quando observar o fechamento do registro pai.