Skip to main content

scapy-mcp

Scaffold status: PyPI name reservation. This package is a placeholder scaffold to claim the scapy-mcp name on PyPI. The MCP server is not yet implemented.

MCP server wrapping Scapy — interactive packet manipulation library. Provides access to:

  • Packet crafting — build L2/L3/L4 packets from Pythonic layers
  • Dissection — decode captured packet bytes into structured summaries
  • Live capture — sniff interfaces with optional BPF filters
  • PCAP I/O — read and write .pcap / .pcapng files
  • Protocol layers — TCP, UDP, ICMP, ARP, DNS, TLS, raw

Reserve the PyPI name

cd /Users/les/Projects/scapy-mcp
uv build
uv publish  # uses UV_PUBLISH_TOKEN from env

The package name scapy-mcp is currently free on PyPI (verified 2026-08-31). Publishing a placeholder 0.1.0 release locks the name.

Connection to flowscape

The flowscape design spec (docs/superpowers/specs/2026-08-31-flowscape-design.md) explicitly lists scapy-mcp as a future integration under Out of scope / future work:

scapy-mcp / unifi-mcp integration — Enrichment plugins for heuristics.py / graph.py — v2+

This scaffold is the name-reservation placeholder for that v2 integration.

Architecture (planned)

Mirrors the raindropio-mcp pattern in this ecosystem:

  • scapy as the core packet manipulation dependency
  • fastmcp for the MCP server surface (tools = scapy operations)
  • oneiric for layered config (settings/scapy-mcp.yaml, local.yaml, env vars) — configures default interface, capture mode (live vs offline), optional SCAPY_MCP_PRIVILEGED_HELPER for /dev/bpf* ACLs
  • mcp-common for bootstrap, health endpoints
  • pydantic/pydantic-settings for typed config models
  • Live capture requires root or a ChmodBPF-style helper (same constraint documented for flowscape)

Status

Phase State
PyPI name reservation pending (run uv publish)
Spec / plan not written
Implementation not started
Tests not started

License

BSD-3-Clause.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scapy_mcp-0.1.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scapy_mcp-0.1.0-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file scapy_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: scapy_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for scapy_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 afd79b6e562b96726519705db3ae7f310813f0865f328e041dca419ab7548468
MD5 d5e482db5b30ab2673c5347e4a3a4123
BLAKE2b-256 2c74a61f04711d02ffb1b8a6a398be799fa82b2b2cc52f33990f72dbf938b812

See more details on using hashes here.

File details

Details for the file scapy_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: scapy_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for scapy_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e7bfecdc0e66eb1b8de0c30d826a608546585fd177b7586247482e0be834359d
MD5 c278ec0ecd72824d3f79a1779ebe91c4
BLAKE2b-256 b25c8b54e541bfe537d9656a65bc79b75b28fb1e5e00aff6892192dcfab60e07

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.1

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page