Duplicacy MCP
Read-only MCP server that reports Duplicacy backup health from a Prometheus exporter
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"duplicacy-mcp": {
"command": "npx",
"args": [
"-y",
"duplicacy-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"duplicacy-mcp": {
"command": "npx",
"args": [
"-y",
"duplicacy-mcp"
]
}
}
}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:9750DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter as the container reaches it, for example http://duplicacy-exporter:9750MCP_AUTH_TOKENBearer token clients must send; the image refuses to start without one. At least 16 characters, for example from openssl rand -hex 32RequiredMCP_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

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents

MagicWP MCP
MCP serverRun WordPress hosting from an assistant: backups, staging, updates, PHP and domains
- Remote
- Free trial
- Cloud and infrastructure

Kubana Cloud Domains
MCP serverSearch, register and renew domains and set nameservers at Kubana Cloud from an assistant
Not checked yet- 3 tools
- Remote
- Paid
- Cloud and infrastructure

Kubana Cloud DNS Management
MCP serverCreate DNS zones, edit records and check nameserver delegation on Kubana Cloud
Not checked yet- 5 tools
- Remote
- Free
- Cloud and infrastructure