Repolode
Enviar
bx33661

bx33661/Wireshark-MCP

Servidor MCP que dá a assistentes de IA acesso estruturado ao tshark para analisar capturas .pcap com dados reais de pacotes.

Alternativa open source a:Wireshark

Ver no GitHub
Estrelas
371
Forks
47
Issues abertas
5
Último commit
há 5 dias

O que é?

O Wireshark MCP é um servidor MCP que integra o tshark e, opcionalmente, ferramentas da suíte Wireshark em uma interface de análise estruturada. Os usuários apontam um cliente de IA compatível com MCP para um arquivo de captura e fazem perguntas em linguagem natural; o assistente responde chamando ferramentas que executam o tshark e retornam a saída. Ele funciona com clientes como Claude Desktop, Claude Code, Cursor e VS Code.

No perfil padrão, o servidor expõe 54 ferramentas que abrangem listagem e detalhes de pacotes, extração de HTTP e DNS, estatísticas agregadas e detectores de segurança para varredura de portas, tunelamento DNS, beaconing, exfiltração e spoofing de ARP. Uma ferramenta de análise de protocolos oferece suporte a 25 protocolos, aplicando os campos e filtros de exibição adequados a cada um. Os resultados dos detectores usam um formato comum de achados, com referências às evidências e um comando do tshark para verificá-los novamente. Um índice opcional de capturas do DuckDB acelera consultas repetidas em arquivos grandes, e arquivos de caso mantêm os achados e as conclusões de uma investigação entre sessões.

A saída das ferramentas tem limite de tamanho, e cada ferramenta informa se lê ou grava dados, permitindo que os clientes aprovem automaticamente análises somente de leitura. Ferramentas que podem gravar dados e a vinculação HTTP remota são limitadas por diretórios configurados e usam loopback por padrão. O pacote pode ser instalado pelo PyPI com um comando interativo de configuração do cliente; também há uma opção de plugin para Claude Code e Codex.

Recursos principais

  • 01Expõe 54 ferramentas MCP baseadas na saída do tshark para análise de pacotes, fluxos, estatísticas e segurança.
  • 02Analisa 25 protocolos por meio de uma ferramenta que seleciona os campos e filtros de exibição adequados.
  • 03Inclui detectores de tunelamento DNS, varredura de portas, beaconing, exfiltração e spoofing de ARP.
  • 04Oferece um índice opcional de capturas do DuckDB para acelerar consultas em capturas grandes.
  • 05Mantém os achados e as conclusões das investigações em arquivos de caso JSON que persistem entre sessões.
  • 06Oferece perfis que reduzem a lista de ferramentas para diminuir o tamanho do prompt em cada solicitação.

Casos de uso

  • Pedir a um assistente de IA que faça uma triagem de um arquivo .pcap em busca de tráfego suspeito de DNS, HTTP ou credenciais.
  • Investigar quando um host apareceu pela primeira vez ou como o tráfego mudou entre duas capturas.
  • Analisar protocolos industriais ou sem fio, como Modbus, S7comm, Zigbee ou BLE, com os nomes corretos dos campos.
  • Conduzir investigações longas de incidentes, registrando os achados e retomando o trabalho entre sessões.

Início rápido

  1. 1

    Instale o Wireshark (que inclui o tshark) e verifique se o tshark está no seu PATH

  2. 2

    Instale o pacote Python pelo PyPI

    pip install wireshark-mcp
  3. 3

    Registre o servidor nos seus clientes MCP (escolha entre os clientes detectados)

    wireshark-mcp install

Antes de usar

  • É necessário instalar o Wireshark com o tshark separadamente; o pacote não faz essa instalação.
  • As ferramentas de leitura e gravação de arquivos rejeitam as operações por segurança até que WIRESHARK_MCP_ALLOWED_DIRS indique diretórios existentes.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

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

Perguntas frequentes

O que é Wireshark-MCP?
Servidor MCP que dá a assistentes de IA acesso estruturado ao tshark para analisar capturas .pcap com dados reais de pacotes. O Wireshark MCP é um servidor MCP que integra o tshark e, opcionalmente, ferramentas da suíte Wireshark em uma interface de análise estruturada. Os usuários apontam um cliente de IA compatível com MCP para um arquivo de captura e fazem perguntas em linguagem natural; o assistente responde chamando ferramentas que executam o tshark e retornam a saída. Ele funciona com clientes como Claude Desktop, Claude Code, Cursor e VS Code.
Wireshark-MCP é gratuito? Qual é a licença?
Wireshark-MCP é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Wireshark-MCP ainda é mantido?
Manutenção ativa. O último commit de Wireshark-MCP foi em 1 de nov. de 2026.
Para que posso usar Wireshark-MCP?
Pedir a um assistente de IA que faça uma triagem de um arquivo .pcap em busca de tráfego suspeito de DNS, HTTP ou credenciais. Investigar quando um host apareceu pela primeira vez ou como o tráfego mudou entre duas capturas. Analisar protocolos industriais ou sem fio, como Modbus, S7comm, Zigbee ou BLE, com os nomes corretos dos campos. Conduzir investigações longas de incidentes, registrando os achados e retomando o trabalho entre sessões.
Como instalar Wireshark-MCP?
Instale o Wireshark (que inclui o tshark) e verifique se o tshark está no seu PATH Instale o pacote Python pelo PyPI: pip install wireshark-mcp Registre o servidor nos seus clientes MCP (escolha entre os clientes detectados): wireshark-mcp install
Onde consigo Wireshark-MCP?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/bx33661/Wireshark-MCP

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

kubeshark / kubeshark

Ferramenta de observabilidade de rede para Kubernetes que captura e indexa o tráfego do cluster com eBPF, descriptografa TLS e disponibiliza os dados para agentes de IA via MCP.

DevOps e nuvem#kubernetes#ebpf#network-observability
12,1 mil+18 esta semana558GoApache-2.0Atualizado há 5 dias