Pentest MCP

Servidor MCP profissional de teste de penetração com suporte moderno a transporte/autenticação e ferramentas de reconhecimento expandidas.

O que mudou na versão 0.9.0

• Atualizado o SDK MCP para @modelcontextprotocol/sdk@^1.26.0
• Mantido o MCP Inspector na versão mais recente (@modelcontextprotocol/inspector@^0.20.0) com lançador integrado
• HTTP Streamable agora é o transporte de rede primário (MCP_TRANSPORT=http)
• SSE ainda está disponível apenas como um modo de compatibilidade obsoleto
• Adicionada autenticação por token bearer com suporte a OIDC JWKS e introspecção
• Adicionadas ferramentas de primeira classe: subfinderEnum, httpxProbe, ffufScan, nucleiScan, trafficCapture, hydraBruteforce, privEscAudit, extractionSweep
• Adicionadas ferramentas de administração de relatórios: listEngagementRecords, getEngagementRecord
• Adicionado fluxo de captura de SoW (Escopo de Trabalho) para relatórios usando elicitação MCP (scopeMode=ask) com fallback seguro para template
• Resolução de comando reforçada para que a sondagem web use httpx-toolkit (preferido) ou httpx validado do ProjectDiscovery, evitando colisões com o CLI httpx do Python
• Lançador integrado do MCP Inspector (pentest-mcp inspector)
• A base de tempo de execução agora é Node.js 22.7.5+
• Adicionados metadados de invocação nas saídas de novas ferramentas quando o contexto de autenticação/sessão está disponível

Ferramentas Incluídas

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

Início Rápido

Instalar

npm install -g pentest-mcp

Executar localmente (stdio)

pentest-mcp

Iniciar o MCP Inspector integrado (sem instalação separada)

pentest-mcp inspector

Você pode encaminhar flags do Inspector diretamente:

pentest-mcp inspector --help

Executar pela rede (HTTP Streamable)

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

Executar modo SSE legado (obsoleto)

MCP_TRANSPORT=sse MCP_SERVER_PORT=8001 pentest-mcp

Notas de Transporte

• stdio: padrão para clientes MCP locais.
• http: transporte de rede moderno. Recomendado.
• sse: apenas compatibilidade. Obsoleto e será removido em uma futura versão principal.

Integração do Inspector

• pentest-mcp inspector inicia o CLI integrado do @modelcontextprotocol/inspector.
• Ele automaticamente direciona este servidor MCP via stdio ao executar:
  • node <this-package-entrypoint> stdio
• Você não precisa instalar o Inspector separadamente.

Configuração de Autenticação (Bearer + OIDC)

Defina estas variáveis de ambiente ao usar MCP_TRANSPORT=http (ou sse se necessário):

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
# modo de validação alternativo/backup opcional:
MCP_OIDC_INTROSPECTION_URL=https://issuer.example.com/oauth/introspect
MCP_OAUTH_CLIENT_ID=...
MCP_OAUTH_CLIENT_SECRET=...

Aliases legados ainda são aceitos temporariamente:

• MCP_OAUTH_ENABLED
• MCP_OAUTH_PROVIDER_URL
• MCP_OAUTH_SCOPES

Fluxo de Trabalho + Relatórios

createClientReport agora suporta modos de manipulação de SoW:

• scopeMode=ask: solicitar usuário via elicitação MCP (recomendado)
• scopeMode=provided: usar valor scopeOfWork diretamente
• scopeMode=template: usar template interno genérico de teste autorizado

Se a elicitação for recusada/indisponível, o relatório automaticamente recorre ao template.

Como os usuários fornecem SoW (no momento)

Ainda não há uma API separada de upload de arquivo. As opções atuais são:

1. Perguntar interativamente via invocação de usuário MCP (elicitação)

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

2. Colar texto SoW diretamente em 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. Usar modo template quando os detalhes do cliente não devem ser compartilhados

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

Como isso reduz o tempo administrativo

• Cada execução de ferramenta armazena um registro de engajamento estruturado (recordId=...) com contexto de invocação.
• Use listEngagementRecords para obter todos os artefatos de trabalho rapidamente.
• Gere o relatório a partir de recordIds selecionados (ou registros mais recentes por padrão) em vez de copiar/colar manualmente.
• Notas de escopo são anexadas automaticamente a partir de uma das opções:
  • formulário de elicitação do usuário (ask)
  • texto SoW colado (provided)
  • template padrão seguro (template)

Roteiro

Estes são planejados especificamente para reduzir a sobrecarga administrativa de pentest.

• Ingestão de scopeFilePath (carregar SoW de um caminho de arquivo local no host MCP)
• Fluxo de upload fragmentado scopeDocument (enviar conteúdo SoW diretamente via MCP para clientes remotos)
• Analisador de SoW que extrai automaticamente alvos, exclusões, janelas de teste e regras de engajamento
• Vinculação automática de evidências das saídas das ferramentas (recordId) a descobertas e seções de relatório
• Deduplicação/mesclagem de descobertas entre ferramentas sobrepostas (nuclei, nikto, etc.)
• Texto de rascunho automático de gravidade + impacto para redações mais rápidas
• Geração de pacote de relatório com um clique (resumo executivo + apêndice técnico + tabela de remediação)
• Modo de diff de reteste (descobertas corrigidas/reabertas/novas entre engajamentos)
• Sincronização de exportação de tickets (Jira/Linear/GitHub) com preenchimento de status
• Verificações de QA de entregáveis (evidências ausentes, campos de escopo ausentes, notas de remediação fracas)

Nota de adoção:

• Espere uso forte para scopeFilePath e scopeDocument porque a maioria das equipes já mantém SoW em documentos/PDF e quer evitar etapas repetitivas de copiar e reformatar.

Exemplos de Reconhecimento + Exploração

Enumeração de subdomínios

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

Sondar hosts ativos

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

Fuzzing de caminhos de conteúdo

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

Varredura de templates

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

Captura de tráfego (sniffing)

{
  "tool": "trafficCapture",
  "arguments": {
    "networkInterface": "eth0",
    "packetCount": 200,
    "bpfFilter": "tcp port 80"
  }
}