bx33661/Wireshark-MCP

어떤 프로젝트인가요?

핵심 기능

• 01패킷, 스트림, 통계 및 보안 분석을 위해 tshark 출력을 활용하는 MCP 도구 54개를 제공합니다.
• 02하나의 프로토콜 도구가 올바른 필드와 디스플레이 필터를 선택해 25개 프로토콜을 분석합니다.
• 03DNS 터널링, 포트 스캔, 비콘 통신, 데이터 유출 및 ARP 스푸핑 탐지 기능을 포함합니다.
• 04대용량 캡처를 더 빠르게 쿼리할 수 있는 선택 사항인 DuckDB 캡처 인덱스를 제공합니다.
• 05세션이 바뀌어도 조사 결과와 판정을 보존하는 JSON 케이스 파일을 지원합니다.
• 06요청마다 프롬프트 크기를 줄이도록 도구 목록을 간소화하는 프로필을 제공합니다.

활용 사례

• AI assistant에게 .pcap 파일을 분석해 의심스러운 DNS, HTTP 또는 자격 증명 트래픽을 선별하도록 요청합니다.
• 호스트가 처음 나타난 시점이나 두 캡처 사이에 트래픽이 어떻게 달라졌는지 조사합니다.
• 올바른 필드 이름을 사용해 Modbus, S7comm, Zigbee, BLE 같은 산업용 또는 무선 프로토콜을 분석합니다.
• 세션을 넘어 조사 결과를 기록하고 이어서 진행해야 하는 장기 인시던트 조사에 사용합니다.

빠른 시작

1. 1

   Wireshark(tshark 포함)을 설치하고 tshark가 PATH에 있는지 확인합니다

2. 2

   PyPI에서 Python 패키지를 설치합니다

   pip install wireshark-mcp
3. 3

   MCP 클라이언트에 서버를 등록합니다(감지된 클라이언트 중에서 선택)

   wireshark-mcp install

사용 전 알아둘 점

• !Wireshark와 tshark를 별도로 설치해야 합니다. 이 패키지에는 포함되어 있지 않습니다.
• !WIRESHARK_MCP_ALLOWED_DIRS에 존재하는 디렉터리를 지정할 때까지 파일 읽기 및 쓰기 도구는 안전을 위해 요청을 거부합니다.

포함된 컬렉션

토픽

자주 묻는 질문

Wireshark-MCP은(는) 무엇인가요?

AI assistant가 실제 패킷 데이터로 .pcap 캡처를 분석할 수 있도록 tshark에 구조화된 접근을 제공하는 MCP 서버입니다. Wireshark MCP는 tshark와 선택적으로 Wireshark 제품군 도구를 감싸 구조화된 분석 인터페이스를 제공하는 MCP 서버입니다. 사용자는 MCP 호환 AI 클라이언트에서 캡처 파일을 지정하고 일상적인 표현으로 질문하면, assistant가 tshark를 실행하는 도구를 호출해 결과를 반환합니다. Claude Desktop, Claude Code, Cursor, VS Code 등의 클라이언트에서 사용할 수 있습니다.

Wireshark-MCP은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Wireshark-MCP은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Wireshark-MCP은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Wireshark-MCP의 마지막 커밋은 2026년 11월 1일입니다.

Wireshark-MCP은(는) 어디에 사용할 수 있나요?

AI assistant에게 .pcap 파일을 분석해 의심스러운 DNS, HTTP 또는 자격 증명 트래픽을 선별하도록 요청합니다. 호스트가 처음 나타난 시점이나 두 캡처 사이에 트래픽이 어떻게 달라졌는지 조사합니다. 올바른 필드 이름을 사용해 Modbus, S7comm, Zigbee, BLE 같은 산업용 또는 무선 프로토콜을 분석합니다. 세션을 넘어 조사 결과를 기록하고 이어서 진행해야 하는 장기 인시던트 조사에 사용합니다.

Wireshark-MCP는 어떻게 설치하나요?

Wireshark(tshark 포함)을 설치하고 tshark가 PATH에 있는지 확인합니다 PyPI에서 Python 패키지를 설치합니다: pip install wireshark-mcp MCP 클라이언트에 서버를 등록합니다(감지된 클라이언트 중에서 선택): wireshark-mcp install

Wireshark-MCP은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/bx33661/Wireshark-MCP