Duplicacy MCP
MCP server for Duplicacy: backup health, status and Prometheus metrics from duplicacy-exporter
Que pouvez-vous faire avec Duplicacy MCP ?
- Reads the metrics of duplicacy-exporter and serves them over MCP.
- Resources
duplicacy://status,duplicacy://progressandduplicacy://healthfor read-only browsing. - Tools
get_backup_status,get_backup_history,list_snapshotsandget_prune_status. - One JSON-RPC endpoint (
/mcp) over HTTP, or stdio throughnpx duplicacy-mcp. - Listens on
127.0.0.1:8080by 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.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
duplicacy-mcpclaude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://localhost:9750' -- npx -y duplicacy-mcp@0.2.0
{
"mcpServers": {
"duplicacy-mcp": {
"command": "npx",
"args": [
"-y",
"duplicacy-mcp@0.2.0"
],
"env": {
"DUPLICACY_EXPORTER_URL": "http://localhost:9750"
}
}
}
}
Variables d'environnement
DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter, for example http://localhost:9750
drumsergio/duplicacy-mcp:v0.2.0claude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750' -e 'MCP_AUTH_TOKEN=<your mcp_auth_token>' -e 'MCP_ALLOWED_ORIGINS=<MCP_ALLOWED_ORIGINS>' -- docker run -i --rm drumsergio/duplicacy-mcp:v0.2.0
{
"mcpServers": {
"duplicacy-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"drumsergio/duplicacy-mcp:v0.2.0"
],
"env": {
"DUPLICACY_EXPORTER_URL": "http://duplicacy-exporter:9750",
"MCP_AUTH_TOKEN": "<your mcp_auth_token>",
"MCP_ALLOWED_ORIGINS": "<MCP_ALLOWED_ORIGINS>"
}
}
}
}
Variables d'environnement
DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter as the container reaches it, for example http://duplicacy-exporter:9750MCP_AUTH_TOKENobligatoire secret Bearer token clients must send; the image refuses to start without one. At least 16 characters, for example from openssl rand -hex 32MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call the endpoint cross-origin
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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://progressandduplicacy://healthfor read-only browsing. - Tools
get_backup_status,get_backup_history,list_snapshotsandget_prune_status. - One JSON-RPC endpoint (
/mcp) over HTTP, or stdio throughnpx duplicacy-mcp. - Listens on
127.0.0.1:8080by 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
Questions fréquentes
Qu'est-ce que Duplicacy MCP ?
MCP server for Duplicacy: backup health, status and Prometheus metrics from duplicacy-exporter
Comment installer Duplicacy MCP ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://localhost:9750' -- npx -y duplicacy-mcp@0.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Duplicacy MCP ?
Oui. Il attend MCP_AUTH_TOKEN, à renseigner dans sa configuration.
Duplicacy MCP est-il open source ?
Oui. Son code est sur GitHub sous licence GPL-3.0.
Qui maintient Duplicacy MCP ?
Il est publié par GeiserX. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.