convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
GeiserX

Duplicacy MCP

GeiserX/duplicacy-mcp

Monitor de backups Duplicacy para LLMs via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra o Duplicacy com sistemas de IA, expondo métricas de backup via Prometheus. Permite que agentes de IA monitorem status, progresso e saúde dos backups em tempo real através de recursos e ferramentas especializadas.

Instalação

$npx convez-ai GeiserX/duplicacy-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
1
Saúde
57%
Último commit
há 1 semana
Versão
v0.2.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Monitorar status e progresso de backups automaticamente
  • Integrar alertas de saúde de backup em pipelines de IA
  • Consultar histórico de snapshots e status de prune via agentes

Veredito

Solução bem arquitetada e madura (registrada em múltiplos repositórios oficiais) para integrar Duplicacy com Claude. Ideal para times que automatizam backup monitoring com IA, embora exija infraestrutura Prometheus existente.

README

A tradução para o português deste README ainda está na fila.


What you get

TypeWhat forMCP URI / Tool id
ResourcesBrowse backup status, progress, and health read-onlyduplicacy://statusduplicacy://progressduplicacy://health
ToolsQuery backup history, list snapshots, and check prune statusget_backup_statusget_backup_historylist_snapshotsget_prune_status

Everything is exposed over a single JSON-RPC endpoint (/mcp). LLMs / Agents can: initialize -> readResource -> listTools -> callTool ... and so on.


Quick-start (Docker Compose)

services:
  duplicacy-mcp:
    image: drumsergio/duplicacy-mcp:0.1.0
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750

Security note: The HTTP transport listens on 127.0.0.1:8080 by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.

Install via npm (stdio transport)

npx duplicacy-mcp

Or install globally:

npm install -g duplicacy-mcp
duplicacy-mcp

This downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one published release.

Local build

git clone https://github.com/GeiserX/duplicacy-mcp
cd duplicacy-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuration

VariableDefaultDescription
DUPLICACY_EXPORTER_URLhttp://localhost:9750Duplicacy Prometheus exporter URL (without trailing /)
LISTEN_ADDR127.0.0.1:8080HTTP listen address (Docker sets 0.0.0.0:8080)
TRANSPORT(empty = HTTP)Set to stdio for stdio transport

Put them in a .env file (from .env.example) or set them in the environment.

Testing

Tested with Inspector and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.

Example configuration for client LLMs

{
  "schema_version": "v1",
  "name_for_human": "Duplicacy-MCP",
  "name_for_model": "duplicacy_mcp",
  "description_for_human": "Monitor Duplicacy backup status, progress, and health via Prometheus metrics.",
  "description_for_model": "Interact with a Duplicacy backup monitoring server that reads metrics from a Prometheus exporter. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with duplicacy://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/duplicacy-mcp/blob/main/LICENSE"
}

Credits

Duplicacy -- lock-free deduplication cloud backup

duplicacy-exporter -- Prometheus exporter for Duplicacy

MCP-GO -- modern MCP implementation

GoReleaser -- painless multi-arch releases

Maintainers

@GeiserX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

Duplicacy-MCP follows the Contributor Covenant Code of Conduct.

Other MCP Servers by GeiserX

Related Projects

ProjectDescription
duplicacy-cli-cronDocker-based encrypted dual-storage backup automation using Duplicacy CLI
duplicacy-exporterReal-time Prometheus exporter for Duplicacy backups
duplicacy-haHome Assistant custom integration for monitoring Duplicacy backups
duplicacy-containerContainer image and Helm chart for running Duplicacy on Kubernetes
Ver o original no GitHub

Bom para

Relacionados