Repolode
Enviar
bx33661

bx33661/Wireshark-MCP

Un servidor MCP que ofrece a los asistentes de IA acceso estructurado a tshark para analizar capturas .pcap con datos reales de paquetes.

Alternativa open source a:Wireshark

Ver en GitHub
Estrellas
371
Forks
47
Issues abiertos
5
Último commit
hace 6 días

¿Qué es?

Wireshark MCP es un servidor MCP que integra tshark y herramientas opcionales de la suite Wireshark en una interfaz de análisis estructurada. Los usuarios conectan un cliente de IA compatible con MCP a un archivo de captura y hacen preguntas en lenguaje natural; el asistente responde llamando a herramientas que ejecutan tshark y devuelven sus resultados. Funciona con clientes como Claude Desktop, Claude Code, Cursor y VS Code.

El servidor ofrece 54 herramientas en el perfil predeterminado, que abarcan el listado y los detalles de paquetes, la extracción de datos HTTP y DNS, estadísticas agregadas y detectores de seguridad para escaneos de puertos, túneles DNS, beaconing, exfiltración y suplantación de ARP. Una herramienta de análisis de protocolos admite 25 protocolos y aplica los campos y filtros de visualización adecuados para cada uno. Los resultados de los detectores comparten un formato de hallazgo común, con referencias a las evidencias y un comando de tshark para volver a comprobarlas. Un índice opcional de capturas en DuckDB acelera las consultas repetidas en archivos grandes, y los archivos de caso conservan los hallazgos y conclusiones de una investigación entre sesiones.

El tamaño de los resultados de las herramientas está limitado, y cada herramienta indica si lee o escribe, para que los clientes puedan aprobar automáticamente los análisis de solo lectura. Las herramientas que pueden escribir y la vinculación HTTP remota están restringidas mediante directorios configurados y valores predeterminados que solo permiten conexiones locales. El paquete se instala desde PyPI con un comando interactivo para configurar el cliente; también hay una opción de plugin para Claude Code y Codex.

Funciones clave

  • 01Ofrece 54 herramientas MCP basadas en los resultados de tshark para analizar paquetes, flujos, estadísticas y seguridad.
  • 02Analiza 25 protocolos mediante una única herramienta que selecciona los campos y filtros de visualización adecuados.
  • 03Incluye detectores de túneles DNS, escaneos de puertos, beaconing, exfiltración y suplantación de ARP.
  • 04Ofrece un índice opcional de capturas en DuckDB para agilizar las consultas en capturas grandes.
  • 05Conserva los hallazgos y conclusiones de las investigaciones en archivos de caso JSON que persisten entre sesiones.
  • 06Ofrece perfiles que reducen la lista de herramientas para disminuir el tamaño del prompt por solicitud.

Casos de uso

  • Pedirle a un asistente de IA que haga una evaluación inicial de un archivo .pcap para detectar tráfico sospechoso de DNS, HTTP o credenciales.
  • Investigar cuándo apareció un host por primera vez o cómo cambió el tráfico entre dos capturas.
  • Analizar protocolos industriales o inalámbricos, como Modbus, S7comm, Zigbee o BLE, con los nombres de campo correctos.
  • Llevar a cabo investigaciones de incidentes prolongadas cuyos hallazgos deban registrarse y retomarse entre sesiones.

Inicio rápido

  1. 1

    Instala Wireshark (que incluye tshark) y asegúrate de que tshark esté en tu PATH

  2. 2

    Instala el paquete de Python desde PyPI

    pip install wireshark-mcp
  3. 3

    Registra el servidor en tus clientes MCP (elige entre los clientes detectados)

    wireshark-mcp install

Antes de usarlo

  • Se requiere instalar Wireshark con tshark por separado; el paquete no lo instala.
  • Las herramientas de lectura y escritura de archivos rechazan las operaciones por seguridad hasta que WIRESHARK_MCP_ALLOWED_DIRS indique directorios existentes.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCP

Temas

#mcp#packet-analysis#tshark#network-security#pcap#wireshark#ai-agents

Preguntas frecuentes

¿Qué es Wireshark-MCP?
Un servidor MCP que ofrece a los asistentes de IA acceso estructurado a tshark para analizar capturas .pcap con datos reales de paquetes. Wireshark MCP es un servidor MCP que integra tshark y herramientas opcionales de la suite Wireshark en una interfaz de análisis estructurada. Los usuarios conectan un cliente de IA compatible con MCP a un archivo de captura y hacen preguntas en lenguaje natural; el asistente responde llamando a herramientas que ejecutan tshark y devuelven sus resultados. Funciona con clientes como Claude Desktop, Claude Code, Cursor y VS Code.
¿Wireshark-MCP es gratuito? ¿Qué licencia tiene?
Wireshark-MCP es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Wireshark-MCP sigue mantenido?
Mantenimiento activo. El último commit de Wireshark-MCP fue el 1 nov 2026.
¿Para qué puedo usar Wireshark-MCP?
Pedirle a un asistente de IA que haga una evaluación inicial de un archivo .pcap para detectar tráfico sospechoso de DNS, HTTP o credenciales. Investigar cuándo apareció un host por primera vez o cómo cambió el tráfico entre dos capturas. Analizar protocolos industriales o inalámbricos, como Modbus, S7comm, Zigbee o BLE, con los nombres de campo correctos. Llevar a cabo investigaciones de incidentes prolongadas cuyos hallazgos deban registrarse y retomarse entre sesiones.
¿Cómo se instala Wireshark-MCP?
Instala Wireshark (que incluye tshark) y asegúrate de que tshark esté en tu PATH Instala el paquete de Python desde PyPI: pip install wireshark-mcp Registra el servidor en tus clientes MCP (elige entre los clientes detectados): wireshark-mcp install
¿Dónde consigo Wireshark-MCP?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/bx33661/Wireshark-MCP

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

kubeshark / kubeshark

Herramienta de observabilidad de red para Kubernetes que captura e indexa el tráfico del clúster con eBPF, descifra TLS y ofrece datos a agentes de IA mediante MCP.

DevOps y nube#kubernetes#ebpf#network-observability
12,1 mil+18 esta semana558GoApache-2.0Actualizado hace 6 días