Packetsniffer
FreeNot checkedPacket capture and analysis for AI assistants: tshark/Wireshark and USBPcap bridge. FastMCP server.
About
Packet capture and analysis for AI assistants: tshark/Wireshark and USBPcap bridge. FastMCP server.
README
MCP server for local network packet capture and PCAP file analysis.
Stack: Python 3.12+ · FastMCP 3.4 · FastAPI · prefab-ui · Multi-provider LLM · Sampling · CodeMode (--agentic)
What can I do with this?
A network debugger you can ask questions of. The agent drives Scapy via one
portmanteau tool (packetsniffer_ops) instead of you wrangling Wireshark/tshark:
| Scenario | Call |
|---|---|
"What is in this capture file?" — analyze any .pcap/.pcapng (yours, a colleague's, a router export). No admin needed. |
packetsniffer_ops(operation="analyze_pcap", file_path="C:/captures/router.pcap") |
"What is phoning home?" — watch DNS queries to find which app contacts which domain. Pass save_path to keep the raw capture as evidence. |
packetsniffer_ops(operation="sniff", filter_expr="udp port 53", count=200, timeout=120, save_path="C:/captures/dns.pcap") |
| "Watch it in the background" — start a capture, don't block the agent. Poll, then collect. Survives across agent sessions in HTTP daemon mode. | start_capture → capture_status → stop_capture |
| "Decode it deeply" — after a capture, extract decoded fields Scapy misses: full DNS answers, HTTP requests, and TLS SNI hostnames (catches encrypted phone-home domains). Requires tshark (ships with Wireshark). | packetsniffer_ops(operation="decode_pcap", file_path="C:/captures/dns.pcap", limit=100) |
| "Why is my service unreachable?" — capture traffic to one port and see whether packets arrive at all, and how the TCP handshake behaves. | packetsniffer_ops(operation="sniff", filter_expr="tcp port 10813", count=30) |
| "What is on my network?" — list interfaces before capturing. | packetsniffer_ops(operation="list_interfaces") |
| "What bytes does this app send my USB device?" — pull the host-to-device data out of a USBPcap capture, with per-endpoint totals and any captured device/interface descriptors (printer class? HID? vendor-specific?). Pure Python, no tshark. | packetsniffer_ops(operation="usb_payloads", file_path="C:/captures/02-dot.pcap", export_path="C:/captures/02-dot.bin") |
| "What does it send over Bluetooth serial?" — RFCOMM (serial port profile) data from a Bluetooth HCI capture (btsnoop log from an Android phone, or Wireshark pcap/pcapng). | packetsniffer_ops(operation="btsnoop_payloads", file_path="C:/captures/btsnoop_hci.log") |
| "Which bytes encode the dot?" — diff two captures (blank label vs one-dot label): shared prefix/suffix, changed byte ranges, per-transfer differences. | packetsniffer_ops(operation="diff_captures", file_path="C:/captures/01-blank.pcap", file_path_b="C:/captures/02-dot.pcap") |
| "Capture USB while I operate the device" — wraps USBPcap's command line for a fixed duration. Unverified live (needs the USBPcap driver, administrator rights). | packetsniffer_ops(operation="usb_list_hubs") then packetsniffer_ops(operation="usb_capture", usb_hub="\\\\.\\USBPcap1", timeout=30, save_path="C:/captures/02-dot.pcap") |
Results come back as structured JSON (flows, protocol mix, per-packet summaries) so the agent can interpret them directly — no pcap GUI needed.
Hardware reverse engineering (USB / Bluetooth):
usb_payloads,btsnoop_payloadsanddiff_captureswork on files anywhere, with no privileges and no tshark. They are tested against synthetic captures, and when tshark is installed a test cross-checks the same files against Wireshark's own dissectors (USBPcap bus/device/endpoint/transfer type/payload, RFCOMM frame types, lengths and check bytes; verified with Wireshark 4.6.8). Not yet tested against a capture from real hardware.usb_capture/usb_list_hubsdriveUSBPcapCMD.exe(winget install desowin.USBPcap; a capture driver, administrator rights, and a reboot before the driver attaches to the USB hubs). The flags used (-d,-o,-A,--devices,--inject-descriptors) match the real tool's--help(USBPcap 1.5.4.0). Orchestration is tested through a fake executable; a live capture has not been run yet.- Bluetooth: the capture must start before the device connects, or the L2CAP channel table is missing and only frames whose checksum verifies are kept. Classic Bluetooth cannot be sniffed from Windows; use an Android phone's HCI snoop log. Credit-based flow control bytes are handled; unusual RFCOMM streams may not decode.
- Method and capture protocol: see the DYMO MobileLabeler plan in devices-mcp,
docs/LABEL_PRINTER_REVERSE_ENGINEERING.md.
Limits / requirements:
analyze_pcapanddecode_pcapwork on files anywhere, no privileges.decode_pcapneeds tshark on PATH (ships with Wireshark —winget install Wireshark). Without it, the op returns a cleanmissing_dependencyerror, nothing else breaks.- Live
sniff/start_capturerequire administrator privileges, and on Windows the Npcap driver (Wireshark's capture backend). - Loopback capture (
127.0.0.1) is unreliable on Windows — this tool shines on WiFi/LAN/DNS traffic and offline capture files, not localhost webapp debugging. - Capture defaults are bounded:
countmax 1000,timeoutmax 300s. Raise the ceilings viaPACKETSNIFFER_MCP_MAX_SNIFF_COUNT/PACKETSNIFFER_MCP_MAX_SNIFF_SECONDSfor long-running captures. - Background captures live in the server process: run the HTTP daemon
(
start.ps1/--http) for captures that outlive a single agent session.stop_capturetakes effect on the next packet — with no traffic on the interface it finishes at the timeout.
Install
uv sync --extra dev
pre-commit install
Run
# stdio (Claude Desktop / Cursor)
uv run python -m packetsniffer_mcp
# HTTP + REST API (direct access)
uv run python -m packetsniffer_mcp --http --port 10920
# CodeMode agentic discovery
uv run python -m packetsniffer_mcp --agentic
# Dev launcher (auto-opens browser; `-Headless` to skip)
.\start.ps1
LLM Providers
Auto-detects local providers (Ollama on :11434, LM Studio on :1234). Configure via environment variables:
| Variable | Purpose |
|---|---|
PACKETSNIFFER_MCP_LLM_PROVIDER |
ollama | lmstudio | openai | anthropic | google |
PACKETSNIFFER_MCP_LLM_MODEL |
Override model name |
PACKETSNIFFER_MCP_LLM_API_KEY |
API key (cloud providers) |
Cloud providers detect their standard env vars: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY.
API Endpoints (HTTP mode)
| Method | Path | Description |
|---|---|---|
| GET | /health |
Health check |
| GET | /api/v1/diagnostics |
Full diagnostics (LLM, tools, system) |
| GET | /api/v1/tools |
List all MCP tools |
| GET | /api/v1/providers |
List LLM providers + presets |
| POST | /api/v1/chat |
Chat with LLM (supports streaming) |
Fleet Surface
| Feature | Entry |
|---|---|
| Help | help tool |
| Status | status tool |
| Prefab card | packetsniffer_mcp_status_card |
| Chat | chat tool (multi-provider LLM) |
| Agentic | agentic_packetsniffer_mcp_workflow |
| Skills | resource://packetsniffer-mcp/skills |
| Capabilities | resource://packetsniffer-mcp/capabilities |
| CodeMode | --agentic or MCP_AGENTIC=1 |
License
MIT © 2026 MCP Studio
Install Packetsniffer in Claude Desktop, Claude Code & Cursor
unyly install packetsnifferInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add packetsniffer -- uvx --from git+https://github.com/sandraschi/packetsniffer-mcp packetsniffer_mcpStep-by-step: how to install Packetsniffer
FAQ
Is Packetsniffer MCP free?
Yes, Packetsniffer MCP is free — one-click install via Unyly at no cost.
Does Packetsniffer need an API key?
No, Packetsniffer runs without API keys or environment variables.
Is Packetsniffer hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Packetsniffer in Claude Desktop, Claude Code or Cursor?
Open Packetsniffer on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Opencode Omniroute Plugin
OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc
by GitHub ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
by paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
by S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
by lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare Packetsniffer with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
