Overview
What is Duplicacy Mcp?
Duplicacy Mcp is a bridge that reads Duplicacy backup metrics from a Prometheus exporter and exposes them as an MCP server. It enables LLMs and AI agents to monitor backup status, progress, and health via read‑only resources and query tools.
How to use Duplicacy Mcp?
You can run it via Docker Compose using the drumsergio/duplicacy-mcp image or install it globally with npm install -g duplicacy-mcp and then run duplicacy-mcp. Configuration is done through environment variables (e.g., DUPLICACY_EXPORTER_URL). The server listens on 127.0.0.1:8080 by default with HTTP transport, or you can set TRANSPORT=stdio for stdio mode.
Key features of Duplicacy Mcp
- Exposes three read‑only resources:
duplicacy://status,duplicacy://progress,duplicacy://health - Provides four tools:
get_backup_status,get_backup_history,list_snapshots,get_prune_status - Single JSON‑RPC endpoint (
/mcp) for all interactions - Supports both HTTP and stdio transport
- Lightweight bridge between Duplicacy Prometheus exporter and MCP clients
Use cases of Duplicacy Mcp
- Monitor real‑time backup health and progress through an LLM interface
- Query backup history and list snapshots without accessing the Duplicacy CLI
- Check prune status to verify storage cleanup activities
- Integrate backup monitoring into AI‑powered dashboards or automation workflows
FAQ from Duplicacy Mcp
What transports does Duplicacy Mcp support?
The server supports both HTTP (listening on 127.0.0.1:8080 by default) and stdio transport, configurable with the TRANSPORT environment variable.
How do I configure the Prometheus exporter URL?
Set the DUPLICACY_EXPORTER_URL environment variable; the default is http://localhost:9750.
Is authentication required?
No, the default authentication type is none. The HTTP endpoint should be kept on localhost or placed behind a reverse proxy with authentication for security.
What tools does Duplicacy Mcp expose?
It exposes four tools: get_backup_status, get_backup_history, list_snapshots, and get_prune_status.
What resources are available?
Three read‑only resources are available: duplicacy://status, duplicacy://progress, and duplicacy://health.
