MCP server for managing BTRFS snapshots via Snapper
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"snapper-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# BTRFS Snapper MCP [](https://pypi.org/project/snapper-mcp/) [](https://claude.ai/code) An MCP (Model Context Protocol) server for managing BTRFS snapshots via [Snapper](http://snapper.io/) and monitoring BTRFS filesystem health. Exposes two unified tools with action-based dispatch to minimize tool proliferation while providing full snapshot management and disk health monitoring. ## Features - **Two-tool design**: `snapper` for snapshots, `btrfs_health` for filesystem monitoring - **Full Snapper support**: list, create, delete, rollback, cleanup, diff, status - **BTRFS health monitoring**: usage, device stats, scrub status, balance status - **Flexible configuration**: Environment variables for cross-system portability - **No hardcoded paths**: Works with any Snapper configuration and mount points ## Installation ### From PyPI (recommended) ```bash pip install snapper-mcp ``` ### Using uvx (no install required) ```bash uvx snapper-mcp ``` ### From source ```bash git clone https://github.com/danielrosehill/BTRFS-Snapper-MCP.git cd BTRFS-Snapper-MCP pip install -e . ``` ## Configuration The server is configured via environment variables, making it portable across systems: | Variable | Default | Description | |----------|---------|-------------| | `SNAPPER_MCP_USE_SUDO` | `true` | Set to `false` if user has direct permissions | | `SNAPPER_MCP_SNAPPER_PATH` | `snapper` | Path to snapper binary | | `SNAPPER_MCP_BTRFS_PATH` | `btrfs` | Path to btrfs binary | | `SNAPPER_MCP_SUDO_PATH` | `sudo` | Path to sudo binary | | `SNAPPER_MCP_DEFAULT_CONFIG` | `root` | Default snapper config name | | `SNAPPER_MCP_DEFAULT_MOUNT` | `/` | Default BTRFS mount point | | `SNAPPER_MCP_TIMEOUT` | `60` | Command timeout in seconds | ## MCP Client Configuration ### Claude Code / Claude Desktop Add to your MCP settings (e…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.