packet-chef-mcp
PacketChef MCP is a zero-dependency network forensics MCP server that dissects PCAP/PCAPng captures and exposes bounded forensic summaries and threat-hunting tools for AI agents.
Analyze PCAP/PCAPng from Base64 input (max 10MB) or local
filePathon stdio (up to 500MB).Generate high-density capture summaries: packet totals, bytes, duration, protocols, talkers, and warnings.
List and paginate packets with protocol filters while enforcing context limits.
Track bidirectional 5-tuple conversations and TCP flag lifecycles.
Parse DNS, HTTP/1.x, TLS SNI, WebSocket frames, and QUIC/HTTP3 SNI.
Detect C2 beacons statistically and DNS tunneling/exfiltration via entropy and label heuristics.
Hunt cleartext credentials and calculate Shannon entropy for payloads.
Compute JA3, JA3S, and JA4 TLS fingerprints with C2/tool attribution hints.
Filter/export PCAP slices and generate Zeek-compatible TSV logs for SIEM ingestion.
Run locally via stdio or remotely via Azure SSE/HTTP with remote filesystem restrictions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@packet-chef-mcp scan traffic.pcapng for DNS exfiltration and C2 beacons"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π¦ PacketChef MCP
Zero-Dependency Network Forensics & PCAP Protocol Dissection Engine for AI Agents
A pure-JavaScript Model Context Protocol (MCP) server that empowers autonomous AI agents (Claude Code, Cursor, Windsurf, Codex, Strix) to dissect PCAP/PCAPng packet captures, reassemble TCP streams, hunt C2 beacons, detect DNS tunneling, and fingerprint TLS handshakes without native toolchains.
π Live Cloud Dashboard β’ β‘ Remote SSE Endpoint β’ π¦ NPM Package β’ π MCP Server Card β’ π€ llms.txt
π Live Cloud Deployment (Azure App Service)
PacketChef MCP is continuously hosted on Microsoft Azure with full HTTPS, SSE streaming, and discovery endpoints active:
Endpoint | Method | URL | Description |
Forensic Sandbox |
| Interactive web dashboard, real-time PCAP analyzer & agent configuration hub | |
Remote MCP SSE |
| Remote Server-Sent Events MCP endpoint for cloud-connected AI agents | |
JSON-RPC Messages |
| Bidirectional MCP JSON-RPC execution gateway | |
Health Probe |
| Real-time liveness check reporting server status and tool count ( | |
MCP Server Card |
| Standardized Model Context Protocol discovery catalog and schema | |
Agent llms.txt |
| Compact machine-readable reference optimized for LLM reasoning ingestion |
Related MCP server: network-forensics-mcp-server
β‘ Why PacketChef MCP?
Traditional network analysis utilities (tshark, libpcap, Python scapy) were designed for human network engineers, not autonomous AI agents:
Toolchain Friction: They require heavy native C/C++ libraries and Python environments that frequently fail to compile in minimal Docker containers, serverless runners, or restricted enterprise endpoints.
Context Window Destruction: Dumping raw hex bytes or verbose packet trees into LLMs consumes tens of thousands of tokens per packet, causing hallucinations, catastrophic context exhaustion, and massive API costs.
PacketChef MCP is built from first principles as an AI-First Network Triage Sensor:
Zero Native Dependencies: 100% pure Node.js
Bufferarithmetic. Runs cross-platform anywhere Node.js runs without root privileges or compilation.Context Economy Shield: Converts raw binary captures into compact, bounded (<2KB) JSON summaries and paginated views (default 20, max 100 packets).
High-Signal Threat Decoders: Dissects the top 90% of real-world cloud/web attack indicators: DNS exfiltration, HTTP verbs, TLS SNI, JA3/JA4 fingerprints, C2 beacon periodicity, WebSockets, and QUIC handshakes.
Dual Transport Security: Local
stdiomode allows local file triage (filePath), while remoteHTTP/SSEmode enforces a strict filesystem jail, accepting only isolated Base64 streams (up to 10MB).
flowchart LR
A[Raw .pcap / .pcapng] --> B[PacketChef Binary Dissector]
B --> C[L2-L4 Decoder<br>Ethernet / IPv4 / IPv6 / TCP / UDP]
C --> D[TCP Stream Reassembler<br>Out-of-Order Splicing]
D --> E[L7 Forensic Analyzers<br>DNS / HTTP / TLS JA3-JA4 / WebSocket / QUIC]
E --> F[Threat Detection Engine<br>C2 Beacons CV / DNS Entropy / Credentials]
F --> G[Context Economy Shield<br>Bounded <2KB JSON Reports]
G --> H[AI Agent: Claude / Cursor / Strix]π Quick Start & Integration
Option 1: Remote Azure SSE (Zero Setup Needed)
Connect your AI agent directly to the live cloud endpoint without installing any local packages:
In Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"packet-chef-cloud": {
"url": "https://packet-chef-e9d4aqbcf3ggf2hx.eastasia-01.azurewebsites.net/sse"
}
}
}In Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"packet-chef": {
"url": "https://packet-chef-e9d4aqbcf3ggf2hx.eastasia-01.azurewebsites.net/sse"
}
}
}Option 2: Local Stdio via NPX (Recommended for Local PCAP Files)
Run locally on your workstation for zero network latency, air-gapped security, and direct file path inspection:
Configuration (claude_desktop_config.json or mcp.json)
{
"mcpServers": {
"packet-chef": {
"command": "npx",
"args": ["-y", "@noorfatima123456/packet-chef-mcp@latest"]
}
}
}Via Claude Code CLI
claude mcp add packet-chef -- npx -y @noorfatima123456/packet-chef-mcp@latestVia Smithery (1-Click Install)
npx -y @smithery/cli install @noor-202401938/packet-chef-mcp --client claudeπ οΈ MCP Tools Catalog (15 Production Forensics Operations)
Tool | Parameters | Output & Forensic Purpose |
|
| L3βL7 High-Density Triage: Generates a compact (<2KB JSON) capture overview: total packets, wire bytes, duration, protocol distribution, top talkers, and enterprise protocol warnings. |
|
| Paginated Packet Records: Bounded metadata listing (index, timestamp, length, 5-tuple, flags) protecting LLM context from raw hex flooding. |
|
| 5-Tuple Flow Tracker: Bidirectional conversation flows ranked by total bytes, tracking complete TCP flag lifecycles ( |
|
| RFC 1035 DNS Parser: Resolves queries and responses (A, AAAA, CNAME, TXT, MX, PTR) with pointer compression loop protection. |
|
| HTTP/1.x Stream Reassembly: Reassembles TCP segments and extracts HTTP verbs, URIs, response codes, headers, and 4KB body previews with cognitive triage hints. |
|
| TLS SNI Extractor: Dissects TLS 1.0β1.3 ClientHello records to extract Server Name Indication (SNI) hostnames without decrypting payloads. |
|
| Statistical C2 Beacon Detector: Computes interval time-delta variance (Coefficient of Variation, jitter %, median interval) to flag periodic Command & Control channels. Filters cloud IMDS and NTP. |
|
| DNS Tunnel & Exfiltration Hunter: Calculates Shannon entropy, subdomain label lengths, and character set encodings (hex/base32/base64) to detect dnscat2, iodine, and Cobalt Strike. |
|
| Cleartext Credential Hunter: Recovers credentials from HTTP Basic/Digest headers, URL query parameters, POST bodies, FTP USER/PASS, and SMTP AUTH. |
|
| Shannon Entropy Evaluator: Evaluates payload randomness (0.0 to 8.0 bits/byte) to separate plaintext, structured code, and compressed/encrypted malware. |
|
| JA3, JA3S & JA4 TLS Fingerprinting: Computes MD5 and JA4 fingerprints with RFC 8701 GREASE filtering and malware attribution profiles. |
|
| RFC 6455 WebSocket Unmasker: Reassembles TCP streams and unmasks client-to-server frames using 4-byte XOR keys with automatic JSON detection. |
|
| RFC 9000 QUIC / HTTP3 Parser: Decodes UDP 443 Initial Handshake packets and extracts TLS 1.3 SNI hostnames, ALPN, and Connection IDs. |
|
| PCAP Slicer & Exporter: Filters packets by IP, port, or protocol and serializes the slice into a standardized classic PCAP binary. |
|
| Zeek TSV Exporter: Generates standardized Zeek TSV logs ( |
π¬ Empirical Claims Audit & Verification
PacketChef MCP was evaluated against a strict 20-point empirical verification suite with raw wire bytes, corrupted buffers, encrypted packets, and adversarial inputs:
================================================================================
π EMPIRICAL CLAIMS AUDIT: 11/11 PACKETCHEF CLAIMS VERIFIED (100% PASS RATE)
================================================================================
[P1] Zero Native Dependencies β
Pure JS Buffer arithmetic (0 node-gyp bindings)
[P2] PCAP & PCAPng Dual Support β
Parsed Classic PCAP (0xa1b2c3d4) & PCAPng (SHB/IDB/EPB)
[P3] L2-L4 Dissection Accuracy β
Wire-accurate Ethernet, IPv4, TCP flags (SYN/ACK), UDP
[P4] TCP Stream Reassembly β
Reassembled 23 bytes from shuffled segments [1, 3, 2]
[P5] Statistical C2 Beaconing β
Detected beaconing via CV algorithm (CV=0.0081 < 0.15)
[P6] DNS Tunneling Detection β
Flagged exfiltration domain via Shannon entropy (4.28 bits)
[P7] TLS Fingerprints (JA3 / JA4) β
Calculated JA3 & JA4 with RFC 8701 GREASE filtering
[P8] RFC 6455 WebSocket De-masking β
Unmasked 4-byte XOR client frame to valid JSON message
[P9] RFC 9000 QUIC / HTTP/3 β
Extracted DCID & tokens from Initial Handshake packet
[P10] Truth-in-Triage Envelope β
Accurately reported unparsed SMB without silent false negatives
[P11] Crash Immunity (Fuzzing) β
Processed 100 malformed byte frames with 0 unhandled crashesπ‘οΈ Architectural Boundaries & Truth-in-Triage
Feature | Supported in PacketChef MCP v2.0 | Architectural Boundary (Out of Scope) | Recommended Deep Tool |
Capture Formats | Classic PCAP ( | Multi-gigabyte continuous packet capture rings |
|
Link Layers | Ethernet II, Linux Cooked SLL ( | 802.11 Radiotap, ZigBee, CAN bus, Cellular radio frames |
|
Network Layers | IPv4, IPv4 Defragmentation (RFC 791), IPv6 ( | SCTP, IPsec ESP payload decryption |
|
Enterprise Protocols | DNS, HTTP/1.x, TLS 1.0β1.3 ClientHello, WebSocket, QUIC v1 Initial | SMB, Kerberos, DCE/RPC β transparently reported via Truth-in-Triage envelope |
|
Memory Capacity | Max 10MB Base64, max 500MB local file, 32MB global stream reassembly ceiling | Multi-gigabyte captures (>500MB) exceeding V8 memory limits |
|
π§ͺ Running the Test Suite
Run the full automated test suite (94 unit, integration, and fuzz tests):
git clone https://github.com/noor202401938-netizen/packet-chef-mcp.git
cd packet-chef-mcp
npm install
npm testπ·οΈ Discoverability Tags & Keywords
mcp, mcp-server, packet-chef, packet-chef-mcp, pcap, pcapng, packet-analysis, network-forensics, modelcontextprotocol, cybersecurity, agentic-ai, claude, cursor, windsurf, strix, ja3, ja4, c2-detection, dns-tunneling, quic, websocket, threat-hunting, incident-response, siem, zeek, azure-app-service.
π License
Apache-2.0 Β© 2026 Noor Fatima
Available Tools
15 toolspacket_detect_beaconsB
Detects periodic C2 beacon communications using statistical time-delta variance (Coefficient of Variation, jitter %, median interval). Filters benign infrastructure (NTP, cloud IMDS, public resolvers) with confidence ratings (HIGH/MEDIUM/LOW).
Inputs: input, filePath, includeBenign, minConnections.
packet_detect_dns_tunnelingA
Identifies DNS data exfiltration and tunneling channels (e.g. dnscat2, iodine, Cobalt Strike DNS beacons). Analyzes Shannon character entropy, subdomain label lengths, character set encodings (hex/base32/base64), and CDN heuristics.
Inputs: input, filePath, minSubdomains.
packet_entropyB
Calculates Shannon entropy (0.0 to 8.0 bits/byte) to evaluate payload randomness and distinguish between plaintext, structured data (JSON/HTML/code), and encrypted / compressed malware or C2 traffic.
Inputs: input, filePath, packetIndex.
packet_extract_conversationsA
Aggregates and tracks bidirectional 5-tuple conversations (src/dst IP, ports, protocol). Computes sent/received packet and byte counts, duration, and TCP flag lifecycles (SYN/ACK/FIN/RST). Ranked by total bytes transferred.
Inputs: input, limit, filePath.
packet_extract_credentialsA
Hunts for cleartext and recoverable credentials in HTTP Basic / Digest headers, URL query parameters, form/JSON POST bodies, FTP USER/PASS commands, and SMTP authentication.
Inputs: input, filePath.
packet_extract_dnsB
Extracts and parses DNS queries and responses (RFC 1035) with label pointer loop protection. Aggregates query counts, unique domain rankings, and transaction details (A, AAAA, CNAME, TXT, MX, PTR).
Inputs: input, limit, filePath, queryType.
packet_extract_httpA
Reassembles TCP streams and extracts HTTP/1.x requests and responses. Parses method, URI, headers, status codes, chunked transfers, body previews (4KB cap), and cognitive guidance hints.
Inputs: input, limit, method, filePath.
packet_extract_quic_sniA
Extracts SNI hostnames, ALPN tags, and Connection IDs (DCID/SCID) from QUIC v1 / HTTP/3 Initial packets over UDP (port 443) via RFC 9001 Section 5.2 Initial Secret AEAD decryption.
Inputs: input, limit, filePath.
packet_extract_tls_sniB
Extracts Server Name Indication (SNI) hostnames and client metadata from TLS ClientHello handshakes. Ranks accessed domains by frequency without decrypting payload data.
Inputs: input, limit, filePath.
packet_extract_websocketB
Reassembles TCP streams and parses RFC 6455 WebSocket frames, unmasking client payloads and decoding text/JSON messages for persistent C2 or chat triage.
Inputs: input, limit, filePath.
packet_filter_exportB
Filters PCAP/PCAPng traffic by IP address, port, protocol, or time window and exports a clean, RFC-compliant classic PCAP binary (base64 or saved to disk).
Inputs: ip, port, input, limit, +2 more.
packet_ja3_fingerprintsA
Extracts and aggregates JA3, JA3S, and JA4 TLS client fingerprints across the capture. Correlates hashes against known C2 frameworks (Cobalt Strike, Metasploit, Sliver) and automation tools.
Inputs: input, limit, filePath.
packet_listC
Returns a paginated list of packet summary records from a PCAP capture. Enforces strict LLM context limits with default limit 20 and max 100.
Inputs: input, limit, offset, filePath, +1 more.
packet_summaryA
High-density L3βL7 triage summary (<2KB JSON). Fast reconnaissance of packet totals, talkers, DNS/HTTP/TLS volumes, and warnings for unparsed enterprise protocols (SMB, Kerberos, SSH).
Inputs: input, filePath.
packet_to_zeek_logsA
Exports connection, DNS, and HTTP events formatted in Zeek-compatible TSV schema (conn.log, dns.log, http.log) for SIEM ingestion into Splunk, ELK, or Wazuh. (Note: Generates TSV schemas, does not execute Zeek scripting engine).
Inputs: input, filePath.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 15 tools
Each tool targets a distinct packet-analysis task: high-level summary/list versus protocol-specific extraction versus detection versus export. The only mild conceptual overlap, packet_summary and packet_list, is clearly resolved by their descriptions.
All names use snake_case with a consistent packet_ prefix, which makes the set easy to scan. Some names are verb-led (packet_extract_*, packet_detect_*) while others are noun-led (packet_summary, packet_entropy, packet_ja3_fingerprints), so the pattern is slightly mixed.
15 tools is at the top of the recommended range but each covers a distinct packet-analysis capability, from triage to protocol extraction to detection to export. There are no redundant placeholder tools or obviously missing core functions.
The surface covers core PCAP triage, extraction (DNS/HTTP/TLS/QUIC/WebSocket), detection (beacons/DNS tunneling), credentials, entropy, filtering, and Zeek export. It warns about unparsed enterprise protocols such as SMB, Kerberos, and SSH but offers no extraction tools for them, which is a minor workaround gap.
Maintenance
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
MCP tools for agents: web research, content extraction, email, DNS, and blockchain intelligence.
Enrich, search, assess, and manage threat intelligence through 80+ typed MCP tools.
Free MCP debugging tools for AI agents and developers. Diagnose failed API and MCP tool calls, identify HTTP errors, validate tool arguments against supported JSON Schema rules, and get actionable troubleshooting recommendations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with direct access to Wireshark network analysis capabilities, enabling live packet capture, PCAP file analysis, protocol statistics, and network monitoring through a secure MCP interface.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to analyze PCAP files for network forensics using Wireshark/tshark, providing high-performance packet inspection, filtering, and protocol analysis through the Model Context Protocol.2MIT
- AlicenseNot gradedqualityCmaintenanceBridges AI assistants and network packet analysis by exposing Wireshark/TShark functionality through MCP, enabling PCAP investigation, protocol discovery, packet filtering, stream analysis, and live capture.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to securely investigate packet captures through Wireshark's tshark engine, with bounded tools for protocol inventory, TCP failure diagnosis, latency measurement, and threat hunting.12MIT