Servidor MCP de OpenSearch

Un servidor de Protocolo de Contexto de Modelo (MCP) para consultar y analizar los registros de seguridad de Wazuh almacenados en OpenSearch.

Características

• Búsqueda de alertas de seguridad con filtrado avanzado

• Obtenga información detallada sobre alertas específicas

• Generar estadísticas sobre eventos de seguridad

• Visualizar tendencias de alertas a lo largo del tiempo

• Informes de progreso para operaciones de larga duración

• Manejo estructurado de errores

Related MCP server: OpenSearch MCP Server

Prerrequisitos

• Node.js v16 o superior

• Acceso a una instancia de OpenSearch que contiene registros de seguridad de Wazuh

Instalación

Opción 1: Usar con npx directamente desde GitHub (recomendado)

Puede ejecutar esta herramienta directamente usando npx sin clonar el repositorio:

Opción 2: Instalación local

1. Clonar este repositorio:

2. Instalar dependencias:

3. Configure sus variables de entorno:

4. Edite el archivo .env con los detalles de su conexión de OpenSearch:

Ejecución del servidor

Iniciar el servidor:

Esto iniciará el servidor en modo stdio.

Habilitar el registro de depuración:

Prueba con MCP CLI:

Esto ejecuta el servidor con la herramienta CLI FastMCP para pruebas interactivas.

Prueba con MCP Inspector:

Esto inicia el servidor y lo conecta al Inspector MCP para la depuración visual.

Herramientas de servidor

El servidor proporciona las siguientes herramientas:

1. Alertas de búsqueda

Busque alertas de seguridad en los datos de Wazuh.

Parámetros:

• query : El texto de la consulta de búsqueda

• timeRange : rango de tiempo (por ejemplo, 1 h, 24 h, 7 d)

• maxResults : Número máximo de resultados a devolver

• index : Patrón de índice para buscar

2. Obtener detalles de la alerta

Obtenga información detallada sobre una alerta específica por ID.

Parámetros:

• id alerta

• index : Patrón de índice

3. Estadísticas de alertas

Obtenga estadísticas sobre alertas de seguridad.

Parámetros:

• timeRange : rango de tiempo (por ejemplo, 1 h, 24 h, 7 d)

• field : Campo por el cual se agregará (por ejemplo, rule.level, agent.name)

• index : Patrón de índice

4. Visualizar la tendencia de alerta

Visualice las tendencias de alerta a lo largo del tiempo.

Parámetros:

• timeRange : rango de tiempo (por ejemplo, 1 h, 24 h, 7 d)

• interval : Intervalo de tiempo para agrupar (por ejemplo, 1 h, 1 d)

• query : Consulta para filtrar alertas

• index : Patrón de índice

Ejemplo de uso

Usando la herramienta MCP CLI:

Uso con un cliente

Para utilizar este servidor MCP con una implementación de cliente:

Licencia

Instituto Tecnológico de Massachusetts (MIT)