SuricataMCP

by Medinios
2
  • Linux
  • Apple

Integrations

  • Provides tools for network traffic analysis using Suricata on Linux systems, allowing for retrieving version information, help documentation, and analyzing PCAP files for security alerts.

  • Enables network traffic analysis using Suricata on macOS, offering capabilities to check Suricata version, access help information, and process PCAP files to identify security threats.

  • Includes documentation and guides published on Medium that explain how to install and use SuricataMCP with Cursor for network security analysis.

SuricataMCP 🚀

SuricataMCP es un servidor de protocolo de contexto de modelo que permite a los clientes MCP usar Suricata de forma autónoma para el análisis del tráfico de red. Permite la interacción programática con Suricata mediante herramientas como get_suricata_version, get_suricata_help y get_alerts_from_pcap_file.

📰 Guía completa en Medium

Para su comodidad, hemos creado un artículo completo en Medium que le explica paso a paso cómo instalar y usar SuricataMCP con Cursor. Optimizando Cursor con SuricataMCP: Seguridad de red al alcance de su mano.


📦 Características

  • 🔡 Obtenga fácilmente la versión de Suricata y la información de ayuda.
  • 📁 Analice archivos .pcap y recupere alertas utilizando una interfaz de herramienta sencilla.
  • 🧠 Creado con el protocolo MCP para una integración perfecta con herramientas de codificación de IA como Cursor.

⬇️ Descargando Suricata

Para utilizar este proyecto, necesitarás descargar e instalar Suricata:

Vaya al sitio oficial de Suricata: https://suricata.io/download/

Siga las instrucciones de instalación para su sistema operativo (Linux, macOS o Windows)

En Linux, también puedes instalarlo mediante el administrador de paquetes, por ejemplo:

bash sudo apt install suricata

Después de la instalación, ubique los archivos binarios y de configuración de Suricata para poder configurar las rutas correctas en config.py.


⚙️ Guía de instalación

Siga estos pasos para configurar SuricataMCP en su sistema:


1. Clonar el repositorio

Abra su terminal y ejecute:

git clone https://github.com/medinios/SuricataMCP.git cd SuricataMCP

2. Instalar dependencias (por ejemplo, si se utiliza un entorno virtual)

pip install -r requirements.txt

3. Edite el archivo config.py para especificar la ruta de instalación de Suricata:

SURICATA_DIR = "/path/to/suricata" SURICATA_EXE_FILE = "suricata" # or "suricata.exe" on Windows

4. Agregue SuricataMCP a su plataforma de IA con:

{ "mcpServers": { "SuricataMcp": { "command": "cmd", "args": ["/c", "mcp", "run", "[YourPath]\\SuricataMcp\\suricata-mcp.py"] } } }

🚀 Uso

Ejecute el servidor MCP localmente desde su plataforma de IA (como Cursor)

Al ejecutarse, el servidor expone las siguientes herramientas MCP:

  • get_suricata_version(): Devuelve la cadena de versión de Suricata.
  • get_suricata_help(): Devuelve la salida de ayuda de la CLI de Suricata.
  • get_alerts_from_pcap_file(pcap_destination: str, destination_folder_results: str): ejecuta Suricata en el archivo .pcap dado y devuelve el contenido de fast.log.

📄 Agregar reglas personalizadas

Para ampliar Suricata con sus propias reglas de detección:

  1. Agregue sus archivos de reglas personalizadas (por ejemplo, custom.rules) al directorio suricata/rules.

⚠️ Descargo de responsabilidad

No estamos afiliados al proyecto oficial Suricata ni a la OISF (Open Information Security Foundation). SuricataMCP es una integración independiente diseñada para uso personal dentro de Cursor. El ejemplo pcap se tomó de PCAP-ATTACK.


🤝 Colaboradores

Este proyecto fue creado por dos desarrolladores apasionados por la seguridad, los sistemas contextuales y la creación de herramientas útiles para la comunidad. Cada línea de código, cada comando CLI y cada integración fueron fruto de una colaboración enfocada y una curiosidad compartida.

Sam Med , Raz Tel-Vered

🤝 Contribuyendo

¡Agradecemos sus relaciones públicas y sugerencias! Hagamos que SuricataMCP sea más accesible y programable.

-
security - not tested
F
license - not found
-
quality - not tested

SuricataMCP es un servidor de protocolo de contexto de modelo que permite a los clientes MCP usar Suricata de forma autónoma para el análisis del tráfico de red. Permite la interacción programática con Suricata mediante herramientas como get_suricata_version, get_suricata_help y get_alerts_from_pcap_file.

  1. 📰 Guía completa en Medium
    1. 📦 Características
      1. ⬇️ Descargando Suricata
        1. ⚙️ Guía de instalación
          1. 1. Clonar el repositorio
          2. 2. Instalar dependencias (por ejemplo, si se utiliza un entorno virtual)
          3. 3. Edite el archivo config.py para especificar la ruta de instalación de Suricata:
          4. 4. Agregue SuricataMCP a su plataforma de IA con:
        2. 🚀 Uso
          1. 📄 Agregar reglas personalizadas
            1. ⚠️ Descargo de responsabilidad
              1. 🤝 Colaboradores
                1. 🤝 Contribuyendo

                  Related MCP Servers

                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol (MCP) server that provides programmatic access to the Supabase Management API. This server allows AI models and other clients to manage Supabase projects and organizations through a standardized interface.
                    Last updated -
                    8
                    84
                    27
                    JavaScript
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A proxy server that converts Model Context Protocol (MCP) messages to Simple Language Open Protocol (SLOP) messages, allowing MCP clients like Claude Desktop to interact with SLOP-compatible servers.
                    Last updated -
                    2
                    10
                    JavaScript
                    MIT License
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    An MCP server that provides a comprehensive interface to Semgrep, enabling users to scan code for security vulnerabilities, create custom rules, and analyze scan results through the Model Context Protocol.
                    Last updated -
                    6
                    140
                    Python
                    MIT License
                    • Linux
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.
                    Last updated -
                    Python

                  View all related MCP servers

                  ID: m32270xo31