scapy-mcp 0.1.0__tar.gz

scapy_mcp-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.hypothesis/
+.complexipy_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.cache/
+.benchmarks/
+.pyscn/
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Project-local
+.oneiric_cache/
+.crackerjack/
+.lycheecache/
+dist/
+
+# Packet captures (test fixtures should be in tests/fixtures/, gitignored)
+*.pcap
+*.pcapng

scapy_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

scapy_mcp-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Les Leslie. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

scapy_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.5
+Name: scapy-mcp
+Version: 0.1.0
+Summary: MCP server wrapping Scapy — packet crafting, dissection, and live capture
+Project-URL: Homepage, https://github.com/lesleslie/scapy-mcp
+Project-URL: Repository, https://github.com/lesleslie/scapy-mcp
+Author-email: Les Leslie <les@wedgwoodwebworks.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Requires-Dist: fastmcp>=2.12.0
+Requires-Dist: httpx2>=0.28.1
+Requires-Dist: mcp-common>=0.18.0
+Requires-Dist: oneiric>=0.16.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: scapy>=2.5.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.9; extra == 'dev'
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 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](https://scapy.net/) — 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
+
+```bash
+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.

scapy_mcp-0.1.0/README.md

@@ -0,0 +1,62 @@
+# 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](https://scapy.net/) — 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
+
+```bash
+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.

scapy_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,79 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "scapy-mcp"
+version = "0.1.0"
+description = "MCP server wrapping Scapy — packet crafting, dissection, and live capture"
+readme = "README.md"
+license = "BSD-3-Clause"
+authors = [
+    { name = "Les Leslie", email = "les@wedgwoodwebworks.com" },
+]
+requires-python = ">=3.14"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "fastmcp>=2.12.0",
+    "httpx2>=0.28.1",
+    "mcp-common>=0.18.0",
+    "oneiric>=0.16.0",
+    "pydantic>=2.5.0",
+    "pydantic-settings>=2.1.0",
+    "scapy>=2.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "ruff>=0.4.8",
+    "mypy>=1.9.0",
+    "bandit>=1.7.9",
+]
+
+[project.scripts]
+scapy-mcp = "scapy_mcp.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/lesleslie/scapy-mcp"
+Repository = "https://github.com/lesleslie/scapy-mcp"
+
+[tool.hatch.build.targets.wheel]
+packages = ["scapy_mcp"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    "/.venv",
+    "/.pytest_cache",
+    "/.mypy_cache",
+    "/.ruff_cache",
+    "/dist",
+    "/tests",
+    "/.cache",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py314"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM", "TCH"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.uv]
+constraint-dependencies = [
+    "aiohttp>=3.14.3",
+    "cryptography>=50.0.0",
+]

scapy_mcp-0.1.0/src/scapy_mcp/__init__.py

@@ -0,0 +1,8 @@
+"""scapy-mcp: MCP server wrapping Scapy for packet crafting and dissection.
+
+Scaffold status: PyPI name reservation only. Implementation pending.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"

scapy_mcp-0.1.0/src/scapy_mcp/__main__.py

@@ -0,0 +1,21 @@
+"""scapy-mcp CLI entry point.
+
+Scaffold stub. Real entry point will dispatch to the FastMCP server
+once the server module is implemented.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> int:
+    """Placeholder entry point. Prints version and exits."""
+    from scapy_mcp import __version__
+
+    print(f"scapy-mcp {__version__} (scaffold — not yet implemented)")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scapy_mcp-0.1.0/src/scapy_mcp/server.py

@@ -0,0 +1,14 @@
+"""FastMCP server stub for scapy-mcp.
+
+Scaffold status: module exists so future `from scapy_mcp.server import mcp`
+imports resolve cleanly. Implementation pending.
+"""
+
+from __future__ import annotations
+
+from fastmcp import FastMCP
+
+mcp = FastMCP("scapy-mcp")
+
+# Tools, resources, and prompts will be registered here once the
+# implementation lands. See the project plan (TBD).