Skip to main content
Glama

🦈 PacketChef MCP

Zero-Dependency Network Forensics & PCAP Protocol Dissection Engine for AI Agents

Azure Live Deployment NPM Version LightNow capabilities Glama

License Node Support Native Dependencies Tests Empirical Claims

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

GET

/

Interactive web dashboard, real-time PCAP analyzer & agent configuration hub

Remote MCP SSE

GET

/sse

Remote Server-Sent Events MCP endpoint for cloud-connected AI agents

JSON-RPC Messages

POST

/messages

Bidirectional MCP JSON-RPC execution gateway

Health Probe

GET

/health

Real-time liveness check reporting server status and tool count (15 tools)

MCP Server Card

GET

/.well-known/mcp/server-card.json

Standardized Model Context Protocol discovery catalog and schema

Agent llms.txt

GET

/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:

  1. 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.

  2. 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 Buffer arithmetic. 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 stdio mode allows local file triage (filePath), while remote HTTP/SSE mode 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 &lt;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"
    }
  }
}

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@latest

Via 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

packet_summary

input?: stringfilePath?: string

L3–L7 High-Density Triage: Generates a compact (&lt;2KB JSON) capture overview: total packets, wire bytes, duration, protocol distribution, top talkers, and enterprise protocol warnings.

packet_list

input?: stringfilePath?: stringoffset?: numberlimit?: number (max 100)protocol?: string

Paginated Packet Records: Bounded metadata listing (index, timestamp, length, 5-tuple, flags) protecting LLM context from raw hex flooding.

packet_extract_conversations

input?: stringfilePath?: stringlimit?: number (max 200)

5-Tuple Flow Tracker: Bidirectional conversation flows ranked by total bytes, tracking complete TCP flag lifecycles (SYN, ACK, FIN, RST).

packet_extract_dns

input?: stringfilePath?: stringqueryType?: stringlimit?: number (max 200)

RFC 1035 DNS Parser: Resolves queries and responses (A, AAAA, CNAME, TXT, MX, PTR) with pointer compression loop protection.

packet_extract_http

input?: stringfilePath?: stringmethod?: stringlimit?: number (max 100)

HTTP/1.x Stream Reassembly: Reassembles TCP segments and extracts HTTP verbs, URIs, response codes, headers, and 4KB body previews with cognitive triage hints.

packet_extract_tls_sni

input?: stringfilePath?: stringlimit?: number (max 200)

TLS SNI Extractor: Dissects TLS 1.0–1.3 ClientHello records to extract Server Name Indication (SNI) hostnames without decrypting payloads.

packet_detect_beacons

input?: stringfilePath?: stringminConnections?: numberincludeBenign?: boolean

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.

packet_detect_dns_tunneling

input?: stringfilePath?: stringminSubdomains?: number

DNS Tunnel & Exfiltration Hunter: Calculates Shannon entropy, subdomain label lengths, and character set encodings (hex/base32/base64) to detect dnscat2, iodine, and Cobalt Strike.

packet_extract_credentials

input?: stringfilePath?: string

Cleartext Credential Hunter: Recovers credentials from HTTP Basic/Digest headers, URL query parameters, POST bodies, FTP USER/PASS, and SMTP AUTH.

packet_entropy

input?: stringfilePath?: stringpacketIndex?: number

Shannon Entropy Evaluator: Evaluates payload randomness (0.0 to 8.0 bits/byte) to separate plaintext, structured code, and compressed/encrypted malware.

packet_ja3_fingerprints

input?: stringfilePath?: stringlimit?: number (max 200)

JA3, JA3S & JA4 TLS Fingerprinting: Computes MD5 and JA4 fingerprints with RFC 8701 GREASE filtering and malware attribution profiles.

packet_extract_websocket

input?: stringfilePath?: stringlimit?: number (max 200)

RFC 6455 WebSocket Unmasker: Reassembles TCP streams and unmasks client-to-server frames using 4-byte XOR keys with automatic JSON detection.

packet_extract_quic_sni

input?: stringfilePath?: stringlimit?: number (max 200)

RFC 9000 QUIC / HTTP3 Parser: Decodes UDP 443 Initial Handshake packets and extracts TLS 1.3 SNI hostnames, ALPN, and Connection IDs.

packet_filter_export

input?: stringfilePath?: stringfilterIp?: stringfilterPort?: numberfilterProtocol?: string

PCAP Slicer & Exporter: Filters packets by IP, port, or protocol and serializes the slice into a standardized classic PCAP binary.

packet_to_zeek_logs

input?: stringfilePath?: stringlogTypes?: string[]

Zeek TSV Exporter: Generates standardized Zeek TSV logs (conn.log, dns.log, http.log) ready for SIEM ingestion (Splunk, Elastic, Wazuh).


πŸ”¬ 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 (.pcap), native PCAPng (.pcapng with SHB, IDB, EPB, SPB)

Multi-gigabyte continuous packet capture rings

mergecap / editcap

Link Layers

Ethernet II, Linux Cooked SLL (113), BSD/Linux Loopback (0), Raw IP (12)

802.11 Radiotap, ZigBee, CAN bus, Cellular radio frames

tshark / aircrack-ng

Network Layers

IPv4, IPv4 Defragmentation (RFC 791), IPv6 (:: zero-compression), IPv6 Ext 44 Fragment Guard

SCTP, IPsec ESP payload decryption

tshark / snort

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

wireshark / zeek

Memory Capacity

Max 10MB Base64, max 500MB local file, 32MB global stream reassembly ceiling

Multi-gigabyte captures (&gt;500MB) exceeding V8 memory limits

zeek / tshark -Y


πŸ§ͺ 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 tools
packet_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

    A3.7/5.0

    Scored across 15 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers