Servidor MCP de enriquecimiento
Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) para realizar enriquecimiento dado un observable proporcionado. La combinación de los servicios configurados y los observables proporcionados determinará a qué servicios de enriquecimiento se llamará.
Esta herramienta proporciona una implementación de servidor MCP simple para realizar enriquecimiento de terceros utilizando servicios comunes (por ejemplo, VirusTotal, Hybrid Analysis, etc.) utilizando el paquete de Python security-cli para realizar enriquecimiento/comunicarse con diferentes servicios.
Servidor MCP
Esta implementación del servidor MCP enrichment-mcp expone las siguientes herramientas .
lookup-observable: un punto final genérico que examina y dirige el observable dado a la herramienta correcta.
Related MCP server: IR Toolshed MCP Server
Servicios soportados
Actualmente se admiten los siguientes servicios y tipos observables:
Si tiene alguna sugerencia o cree que se debería implementar otro servicio, ¡cree un problema o una solicitud de extracción!
Nombre | Se requiere clave API | Soporta IP | Admite dominio | Admite URL | Admite correo electrónico |
VirusTotal | Sí | Sí | Sí | Sí | No |
Análisis híbrido | Sí | Sí | Sí | Sí | No |
Bóveda alienígena | Sí | Sí | Sí | Sí | No |
Shodan | Sí | Sí | Sí | Sí | No |
Urlscan.io | Sí | Sí | Sí | Sí | No |
AbuseIPDB | Sí | Sí | No | No | No |
He sido derrotado | Sí | No | No | No | Sí |
Requisitos
Este servicio MCP utiliza security-cli y un archivo config.yaml.example personalizado para determinar qué servicios de enriquecimiento de terceros son compatibles con las búsquedas observables.
La forma más fácil de ejecutar esto en un sistema/Mac local es:
Esto requiere que utilice la plantilla proporcionada .env.example y cree un nuevo archivo .env con sus secretos.
NOTA: Consulte la documentación de security-cli para obtener información sobre la configuración de los diferentes servicios. La configuración predeterminada es suficiente para la mayoría de los casos de uso.
Variables ambientales
NOTA: Se recomienda encarecidamente configurar los secretos como variables de entorno al implementar este servicio. ¡Deja de almacenar secretos, idiota!
Para que el paquete security-cli detecte estas variables, deben tener un formato específico. A continuación, se muestra la lista de variables compatibles actualmente:
ENRIQUECIMIENTO_MCP_VIRUSTOTAL_CLAVE
ENRIQUECIMIENTO_MCP_ANÁLISIS_HÍBRIDO_CLAVE
ENRIQUECIMIENTO_MCP_ALIENVAULT_CLAVE
ENRIQUECIMIENTO_MCP_SHODAN_CLAVE
ENRIQUECIMIENTO_MCP_URLSCAN_CLAVE
ENRIQUECIMIENTO_MCP_ABUSEIPDB_CLAVE
ENRIQUECIMIENTO_MCP_HIBP_CLAVE
Configuración de enriquecimientos
Cada servicio de enriquecimiento se define en el archivo de configuración de securiy-cli . Además, he desglosado los diferentes tipos de enriquecimiento que se pueden realizar. Esto significa que, en la implementación actual, tenemos un único tipo de acción llamado enrich pero en el futuro se podrá ampliar para funciones como scans , queries , etc.
Debajo de estas acciones de alto nivel, enumeramos el tipo de observable, seguido de una lista de servicios que lo admiten. Los tipos de observables actualmente admitidos son:
direcciónip - direcciones ipv4
dominio - Un dominio o netloc
url: una URL completa con esquema, etc.
correo electrónico - Una dirección de correo electrónico estándar
También admitimos estos tipos, pero actualmente no están implementados:
md5 - Un hash MD5 de archivo
sha1 - Un hash SHA1 de archivo
sha256 - Un hash SHA256 de archivo
Cada servicio debe tener un name y una template . Se puede proporcionar el campo apikey , pero recomendamos usar variables de entorno.
Plantillas de indicaciones
Cada servicio y tipo de observable puede tener su propia plantilla de respuesta. Estas se encuentran en el directorio de plantillas de security-cli y se espera que todas las plantillas se encuentren aquí.
Cada servicio definido tiene una plantilla de solicitud que utiliza plantillas de jinja2. Puede modificarlas según sea necesario, pero el formato del nombre de archivo debe ser el mismo.
Estos archivos tienen el siguiente patrón de nombre de archivo.
Asegúrese de que el objeto de respuesta tenga los campos correctos en la plantilla o recibirá un error.
A continuación se muestra un ejemplo de salida para un mensaje de Enrich this IP 91.195.240.94 con algunos errores incluidos:
Uso del servidor MCP
Para utilizar un servidor prediseñado, instrucciones desde aquí: https://modelcontextprotocol.io/quickstart/user
Descargar Claude para escritorio
Instalar uv
Descargue este repositorio y agréguelo a la configuración de Claude para escritorio
Claude para escritorio > Configuración > Desarrollador > Editar configuración
Puede copiar el archivo .desktop_config.example.json proporcionado
Si quieres crearlo tú mismo, estas son las rutas para Claude Desktop.
Abra el archivo de configuración en cualquier editor de texto. Reemplace el contenido del archivo con esto:
Reiniciar Claude para escritorio
Ahora debería ver dos íconos en la barra de chat: un martillo que muestra las herramientas disponibles y un ícono de conexión que muestra el mensaje definido y la entrada requerida.
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar solicitudes de incorporación de cambios.