passive_dorks_server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
PTES Passive Reconnaissance AI Agent
Agente Autónomo de Inteligencia Pasiva y Reconocimiento OSINT alineado con la metodología PTES (Penetration Testing Execution Standard).
🎯 Concepto del Agente
El PTES Passive Reconnaissance AI Agent es una solución avanzada de ciberseguridad impulsada por Inteligencia Artificial, diseñada para automatizar y estandarizar la Fase 2 (Reconocimiento e Inteligencia Pasiva) del marco PTES[cite: 2].
A diferencia de los escáneres tradicionales, este agente utiliza un enfoque basado en orquestación por grafos de estado (LangGraph) y mecanismos de control estricto (Guardrails). Su objetivo principal es recolectar, estructurar y almacenar información de fuentes abiertas (OSINT) sobre infraestructuras o entidades objetivo sin realizar interacción directa no autorizada ni escaneos activos que puedan ser detectados o violar normativas legales.
Related MCP server: NmapMCP
🤖 Tipo de Agente y Función Principal
Tipo de Agente
Categoría: Agente Cognitivo de Seguridad / OSINT Orchestrator Agent.
Modelo de Control: Determinista guiado por grafos de estado (LangGraph State Graph).
Paradigma de Memoria: Memoria a largo plazo vectorial distribuida (ChromaDB).
Arquitectura de Herramientas: Servidor extensible mediante el protocolo estándar MCP (Model Context Protocol).
Función Principal
Onboarding & Gobierno de Alcance: Clasifica el activo objetivo (infraestructura de red o entidad/persona) y genera un archivo JSON formal de Reglas de Compromiso (RoE / Rules of Engagement)[cite: 2].
Validación de Seguridad (Guardrails): Garantiza que ninguna operación se ejecute fuera de los dominios o rangos IP explícitamente autorizados mediante su motor
ScopeEnforcer[cite: 2].Recolección Pasiva (OSINT): Agrega datos de inteligencia pasiva (descubrimiento de subdominios, registros corporativos, huellas digitales)[cite: 2].
Persistencia Vectorial: Indexa y convierte las evidencias en embeddings para permitir consultas contextuales y búsquedas semánticas en fases posteriores del análisis[cite: 2].
💡 Casos de Uso
Equipos de Red Team & Pentesting: Automatización de la fase inicial de footprinting reduciendo tiempos de recolección de horas a segundos.
Equipos de Blue Team & Threat Intelligence: Identificación de la superficie de ataque expuesta (External Attack Surface Management - EASM) antes de que sea explotada por terceros.
Auditorías de Cumplimiento e Infraestructura: Verificación de la huella digital pasiva corporativa bajo alineación estricta de alcance legal.
🏗️ Estructura del Proyecto
├── src/ │ ├── agent/ │ │ ├── onboarding.py # Clasificación de objetivos y generación automática de RoE │ │ ├── state.py # Definición del esquema de estado del agente (TypedDict) │ │ ├── guardrails.py # ScopeEnforcer: Validación de límites de IP/FQDN autorizados │ │ ├── memory_manager.py # Conector y gestor de persistencia en ChromaDB │ │ └── graph_orchestrator.py # Orquestador del flujo condicional mediante LangGraph │ └── mcp_server/ │ └── passive_dorks_server.ts # Servidor TypeScript basado en MCP para herramientas pasivas ├── tests/ # Pruebas unitarias y de validación de guardrails ├── scope/ # Directorio donde se almacenan los archivos RoE generados ├── docker-compose.yml # Configuración de despliegue en contenedores ├── Dockerfile # Construcción de entorno híbrido (Python + Node.js) ├── requirements.txt # Dependencias de Python └── package.json # Dependencias y scripts de TypeScript/MCP
🚀 Puesta en Marcha Rápida
Requisitos Previos
Python 3.11+
Node.js v18+ y
npm
1. Instalación Local
Clone el repositorio
git clone <URL_DEL_REPOSITORIO> cd ptes-passive-recon-agent
Instale dependencias de Python y Node.js
pip install -r requirements.txt npm install && npm run build
2. Configuración de Variables de Entorno
Copie el archivo de ejemplo y configure sus llaves de API:
cp .env.example .env
3. Ejecución del Agente
Ejecute el orquestador principal para iniciar la sesión interactiva de CLI[cite: 2]:
python src/agent/graph_orchestrator.py
4. Ejecución con Docker Compose
Si prefiere ejecutar el entorno completamente aislado[cite: 2]:
docker-compose up --build -d
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Enrich, search, assess, and manage threat intelligence through 80+ typed MCP tools.
MCP tools for agents: web research, content extraction, email, DNS, and blockchain intelligence.
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Defensive Shodan search and host intelligence MCP using customer-provided SHODAN_API_KEY for
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server to perform various OSINT tasks by leveraging common network reconnaissance tools.48-
- FlicenseBqualityCmaintenanceEnables network scanning and reconnaissance tasks like port scanning, OS detection, DNS brute force, and more through MCP interfaces.159-
- AlicenseAqualityDmaintenanceEnables LLMs to conduct passive attack-surface research by collecting public information, referencing saved reports, and verifying evidence through MCP tools.6MIT
- AlicenseBqualityCmaintenanceEnables AI agents to perform general-purpose open-source intelligence lookups across domains, infrastructure, identity, social media, and threat/breach sources through a unified MCP interface, with most tools free and no API keys required.32MIT