drumsergio/duplicacy-mcp repository overview

⁠Duplicacy MCP

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.

⁠Features

• Reads the metrics of duplicacy-exporter⁠ and serves them over MCP.
• Resources duplicacy://status, duplicacy://progress and duplicacy://health for read-only browsing.
• Tools get_backup_status, get_backup_history, list_snapshots and get_prune_status.
• One JSON-RPC endpoint (/mcp) over HTTP, or stdio through npx duplicacy-mcp.
• Listens on 127.0.0.1:8080 by default. Put a reverse proxy with authentication in front before exposing it.
• Ships as Go binaries for several platforms (GoReleaser), a Docker image and an npm wrapper.

⁠Quick start

docker run -d -p 127.0.0.1:8080:8080 -e DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750 drumsergio/duplicacy-mcp:v0.1.0

That serves http://127.0.0.1:8080/mcp. For a client that starts the server itself over stdio, use the npm package in an mcpServers block:

{
  "mcpServers": {
    "duplicacy": {
      "command": "npx",
      "args": ["-y", "duplicacy-mcp"],
      "env": { "DUPLICACY_EXPORTER_URL": "http://localhost:9750" }
    }
  }
}

Compose, a global npm install and a local build are in Getting started⁠.

⁠Documentation

• Getting started⁠: Docker Compose, npm, local build, first run
• Configuration⁠: environment variables, client config for stdio and HTTP
• Usage⁠: resources and tools
• Development⁠: testing with Inspector, credits, contributing
• Related projects⁠: the Duplicacy family, other MCP servers, registry listings

⁠Related projects

Part of the Duplicacy family: duplicacy-exporter⁠, duplicacy-cli-cron⁠, duplicacy-ha⁠, duplicacy-container⁠.

⁠License

GPL-3.0-or-later⁠