bx33661/wireshark-mcp

와이어샤크 MCP

AI 어시스턴트에게 패킷 분석기를 주세요.

.pcap 파일을 제출하고, 쉬운 영어로 질문하세요 — 실제 tshark 데이터를 뒷받침하는 답변을 얻으세요.

영어 • 中文 • 문서 • 변경 기록 • 로드맵 • 기여

---

이게 뭐야?

tshark(및 선택적 Wireshark 제품군 도구)를 구조화된 분석 인터페이스로 감싸는 MCP 서버입니다. Claude Desktop, Claude Code, Cursor, VS Code 및 기타 18+ MCP 클라이언트와 호환됩니다.

---

설치

클로드 코드 / 코덱스 플러그인 경로

전제 조건: [uv 및 Wireshark CLI (tshark). 이 플러그인에는 이 프로젝트와 두 가지 기술이 모두 포함되어 있습니다; 클라이언트는 잠긴 Python 프로젝트를 uv를 통해 stdio를 통해 실행합니다. Wireshark나 캡처 드라이버는 설치하지 않습니다.

이 플러그인 매니페스트가 포함된 체크아웃에서 클라이언트를 선택하세요:

로컬 설치, 구버전 새로고침, 환경 설정 및 게시 후 GitHub 진입점은 플러그인 배포판을 참조하세요. 이 경로 또는 아래의 전통적인 등록 경로를 선택하세요, 둘 다 선택하지 마세요.

전통적인 파이썬 패키지 경로

선수 조건: Python 3.10+와 Wireshark, PATH에서 tshark.

Wireshark MCP 3.0은 안정적인 MCP Python SDK 2를 사용합니다.

---

What is this?

An MCP server that wraps tshark (and optional Wireshark suite tools) into a structured analysis interface. Works with Claude Desktop, Claude Code, Cursor, VS Code, and 18+ other MCP clients.

You:    "Find all DNS queries going to suspicious domains in this capture."
Claude: [calls wireshark_extract_dns_queries → wireshark_detect_dns_tunnel]
        "Found repeated high-entropy DNS queries consistent with tunneling: ..."

New in 4.0

• Capture index. With the optional [index] extra, wireshark_index dissects a capture once into a local DuckDB file. Later wireshark_aggregate and wireshark_extract_fields calls read it with answers identical to tshark: 408× faster at 1 GB, and at 10 GB it answers questions the tshark path stops on. It also adds read-only SQL, capture sets, first-seen timelines, capture or window diffs and Parquet export. See Capture index.
• One finding shape. Every detector returns data.findings with a stable id, evidence anchors, a native tshark command to re-check it and candidate ATT&CK techniques.
• Case files. wireshark_case keeps captures, recorded results, findings and analyst verdicts in a JSON case file, so a long investigation survives a context reset. See Findings and cases.