{ "markdown": "

\n \"Duplicacy\n

\n\n

Duplicacy-MCP

\n\n

\n \"codecov\"/\n \"npm\"/\n \"Go\"/\n \"Docker\n \"GitHub\n \"License\"/\n

\n

\n \"Official\n \"Glama\n \"MCPServers.org\"/\n \"mcp.so\"/\n \"ToolSDK\n \"listed\n

\n\n

A tiny bridge that reads Duplicacy backup metrics from a Prometheus exporter and exposes them as an MCP server, enabling LLMs to monitor backup status, progress, and health.

\n\n---\n\n## What you get\n\n| Type | What for | MCP URI / Tool id |\n|---------------|------------------------------------------------------------|----------------------------------|\n| **Resources** | Browse backup status, progress, and health read-only | `duplicacy://status`
`duplicacy://progress`
`duplicacy://health` |\n| **Tools** | Query backup history, list snapshots, and check prune status | `get_backup_status`
`get_backup_history`
`list_snapshots`
`get_prune_status` |\n\nEverything is exposed over a single JSON-RPC endpoint (`/mcp`).\nLLMs / Agents can: `initialize` -> `readResource` -> `listTools` -> `callTool` ... and so on.\n\n---\n\n## Quick-start (Docker Compose)\n\n```yaml\nservices:\n duplicacy-mcp:\n image: drumsergio/duplicacy-mcp:0.1.0\n ports:\n - \"127.0.0.1:8080:8080\"\n environment:\n - DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750\n```\n\n> **Security note:** The HTTP transport listens on `127.0.0.1:8080` by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.\n\n## Install via npm (stdio transport)\n\n```sh\nnpx duplicacy-mcp\n```\n\nOr install globally:\n\n```sh\nnpm install -g duplicacy-mcp\nduplicacy-mcp\n```\n\nThis downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one [published release](https://github.com/GeiserX/duplicacy-mcp/releases).\n\n## Local build\n\n```sh\ngit clone https://github.com/GeiserX/duplicacy-mcp\ncd duplicacy-mcp\n\n# (optional) create .env from the sample\ncp .env.example .env && $EDITOR .env\n\ngo run ./cmd/server\n```\n\n## Configuration\n\n| Variable | Default | Description |\n|--------------------------|----------------------------|------------------------------------------------------|\n| `DUPLICACY_EXPORTER_URL` | `http://localhost:9750` | Duplicacy Prometheus exporter URL (without trailing /)|\n| `LISTEN_ADDR` | `127.0.0.1:8080` | HTTP listen address (Docker sets `0.0.0.0:8080`) |\n| `TRANSPORT` | _(empty = HTTP)_ | Set to `stdio` for stdio transport |\n\nPut them in a `.env` file (from `.env.example`) or set them in the environment.\n\n## Testing\n\nTested with [Inspector](https://modelcontextprotocol.io/docs/tools/inspector) and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.\n\n## Example configuration for client LLMs\n\n```json\n{\n \"schema_version\": \"v1\",\n \"name_for_human\": \"Duplicacy-MCP\",\n \"name_for_model\": \"duplicacy_mcp\",\n \"description_for_human\": \"Monitor Duplicacy backup status, progress, and health via Prometheus metrics.\",\n \"description_for_model\": \"Interact with a Duplicacy backup monitoring server that reads metrics from a Prometheus exporter. First call initialize, then reuse the returned session id in header \\\"Mcp-Session-Id\\\" for every other call. Use readResource to fetch URIs that begin with duplicacy://. Use listTools to discover available actions and callTool to execute them.\",\n \"auth\": { \"type\": \"none\" },\n \"api\": {\n \"type\": \"jsonrpc-mcp\",\n \"url\": \"http://localhost:8080/mcp\",\n \"init_method\": \"initialize\",\n \"session_header\": \"Mcp-Session-Id\"\n },\n \"contact_email\": \"acsdesk@protonmail.com\",\n \"legal_info_url\": \"https://github.com/GeiserX/duplicacy-mcp/blob/main/LICENSE\"\n}\n```\n\n## Credits\n\n[Duplicacy](https://duplicacy.com/) -- lock-free deduplication cloud backup\n\n[duplicacy-exporter](https://github.com/GeiserX/duplicacy-exporter) -- Prometheus exporter for Duplicacy\n\n[MCP-GO](https://github.com/mark3labs/mcp-go) -- modern MCP implementation\n\n[GoReleaser](https://goreleaser.com/) -- painless multi-arch releases\n\n## Maintainers\n\n[@GeiserX](https://github.com/GeiserX).\n\n## Contributing\n\nFeel free to dive in! [Open an issue](https://github.com/GeiserX/duplicacy-mcp/issues/new) or submit PRs.\n\nDuplicacy-MCP follows the [Contributor Covenant](http://contributor-covenant.org/version/2/1/) Code of Conduct.\n\n## Other MCP Servers by GeiserX\n\n- [cashpilot-mcp](https://github.com/GeiserX/cashpilot-mcp) — Passive income monitoring\n- [genieacs-mcp](https://github.com/GeiserX/genieacs-mcp) — TR-069 device management\n- [lynxprompt-mcp](https://github.com/GeiserX/lynxprompt-mcp) — AI configuration blueprints\n- [pumperly-mcp](https://github.com/GeiserX/pumperly-mcp) — Fuel and EV charging prices\n- [telegram-archive-mcp](https://github.com/GeiserX/telegram-archive-mcp) — Telegram message archive\n\n## Related Projects\n\n| Project | Description |\n|---------|-------------|\n| [duplicacy-cli-cron](https://github.com/GeiserX/duplicacy-cli-cron) | Docker-based encrypted dual-storage backup automation using Duplicacy CLI |\n| [duplicacy-exporter](https://github.com/GeiserX/duplicacy-exporter) | Real-time Prometheus exporter for Duplicacy backups |\n| [duplicacy-ha](https://github.com/GeiserX/duplicacy-ha) | Home Assistant custom integration for monitoring Duplicacy backups |\n| [duplicacy-container](https://github.com/GeiserX/duplicacy-container) | Container image and Helm chart for running Duplicacy on Kubernetes |\n", "bytes": 7672, "sha": "cc6ae10f513fe0d0f8d72a96f2616f57d817f27e3884c7c2eaacb80f0a63c699", "repo_slug": "geiserx/duplicacy-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_geiserx_duplicacy_mcp_a5407bef/readme" }