io.github.GeiserX/duplicacy-mcp — Duplicacy MCP Server

This MCP server for Duplicacy monitors backup status and provides Prometheus metrics. It is designed to work with Model Context Protocol (MCP) over JSON-RPC and is delivered as a self-hosted, container-friendly component. The project targets developer environments using Go/Golang.

🛠️ Key Features

Duplicacy backup status monitoring
Prometheus metrics export
MCP server implementation (Model Context Protocol)
JSON-RPC and stdio compatibility implied by MCP tooling
Built with Go/Golang

🚀 Use Cases

Monitor backup health for Duplicacy-managed jobs
Expose backup-related metrics to Prometheus
Integrate backup monitoring into an MCP-based toolchain
Run in homelab and self-hosted setups

⚡ Developer Benefits

Go/Golang codebase
Prometheus-ready metrics for dashboards/alerting
Docker-friendly deployment for infrastructure setups

⚠️ Limitations

Details such as tool count are not provided in the available source data.

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

bash

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:

json

{
  "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.

Install

Configuration

Environment variables

DUPLICACY_EXPORTER_URLrequired

Duplicacy Prometheus exporter URL (e.g. http://localhost:9750)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp@0.1.1"
      ],
      "env": {
        "DUPLICACY_EXPORTER_URL": "<YOUR_DUPLICACY_EXPORTER_URL>"
      }
    }
  }
}

io.github.GeiserX/duplicacy-mcp