Skip to content
MCP server

Duplicacy MCP

Read-only MCP server that reports Duplicacy backup health from a Prometheus exporter

Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.2
Listing updated
2 days ago

About Duplicacy MCP

Duplicacy MCP is an open-source MCP server for cloud and infrastructure. It can run locally on your machine or as a hosted remote server.

Rather than reading backup storage itself, this bridge reads the metrics of duplicacy-exporter and exposes them to an assistant. The headline call, get_backup_overview, gives every backup a verdict of ok, running, stale, never or failed with a reason and the age of the last success; max_age_hours (default 26) decides when a backup counts as stale.

Other tools list snapshot IDs and targets, show one snapshot's state, report the last completed run, show whether a prune is running, and summarise storage size and revisions. Everything is read-only and tools carry readOnlyHint. It also offers three resources: duplicacy://status, progress and health.

HTTP mode listens on 127.0.0.1:8080 by default; any other address needs a bearer token. The Docker image refuses to start without MCP_AUTH_TOKEN. Licensed GPL-3.0-or-later.

Install

Run in a terminal

claude mcp add duplicacy-mcp -- npx -y duplicacy-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "duplicacy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}

Configuration

  • DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter, for example http://localhost:9750
  • DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter as the container reaches it, for example http://duplicacy-exporter:9750
  • MCP_AUTH_TOKENBearer token clients must send; the image refuses to start without one. At least 16 characters, for example from openssl rand -hex 32Required
  • MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call the endpoint cross-origin

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

get_backup_overview
Health verdict for every backup with reason and age of last success.
list_snapshots
Snapshot IDs, storage targets and machines.
get_backup_status
State and last-run details of one snapshot.
get_backup_history
Last completed run of one snapshot.
get_prune_status
Whether a prune is running and when the last one succeeded.
get_storage_usage
Storage size, chunks and revisions per snapshot.

What it does

Backup verdicts
One call labels each backup ok, running, stale, never or failed.
Snapshot status
Per-snapshot state across storage targets and machines.
Prune status
Shows whether a prune is running and when one last succeeded.
Storage usage
Reports size, chunks and revisions per snapshot.
Read-only by design
Tools only read the exporter.
Stdio and HTTP
Runs through npm over stdio or as a Docker image over HTTP.
Token-protected HTTP
Non-loopback addresses require a bearer token.

Good for

  • Ask whether last night's backups succeeded
  • Spot snapshots that have gone stale
  • Check whether a prune is still running
  • Watch storage growth per snapshot

Pricing

Open source

Duplicacy MCP FAQ

What does it need?

A running duplicacy-exporter; set DUPLICACY_EXPORTER_URL to its address.

Can it change my backups?

No. Every tool and resource only reads the exporter.

How are staleness thresholds set?

get_backup_overview takes max_age_hours, defaulting to 26.

What licence is it under?

GPL-3.0-or-later.

How much history is available?

The exporter keeps only the last run, so get_backup_history returns the last completed run of one snapshot.

Is Duplicacy MCP free?

Yes. Duplicacy MCP is open source, so you can use and self-host it for free.

How do I add Duplicacy MCP to Claude Code?

Run this command in your terminal: claude mcp add duplicacy-mcp -- npx -y duplicacy-mcp

What are the best alternatives to Duplicacy MCP?

The closest alternatives to Duplicacy MCP are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

Alternatives to Duplicacy MCP

  1. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  2. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  3. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents
  4. MagicWP MCP

    MCP server

    Run WordPress hosting from an assistant: backups, staging, updates, PHP and domains

    • Remote
    • Free trial
    • Cloud and infrastructure
  5. Search, register and renew domains and set nameservers at Kubana Cloud from an assistant

    Not checked yet
    • 3 tools
    • Remote
    • Paid
    • Cloud and infrastructure
  6. Create DNS zones, edit records and check nameserver delegation on Kubana Cloud

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Cloud and infrastructure