Duplicacy MCP

Monitore o status do backup e consulte métricas do Prometheus a partir de um exportador Duplicacy

Documentação

Duplicacy-MCP

Uma pequena ponte que lê métricas de backup do Duplicacy de um exportador Prometheus e as expõe como um servidor MCP, permitindo que LLMs monitorem o status, o progresso e a saúde dos backups.

O que você obtém

Tipo	Para que serve	URI MCP / ID da ferramenta
Recursos	Navegar pelo status, progresso e saúde dos backups (somente leitura)	`duplicacy://status` `duplicacy://progress` `duplicacy://health`
Ferramentas	Consultar histórico de backups, listar snapshots e verificar status de poda	`get_backup_status` `get_backup_history` `list_snapshots` `get_prune_status`

Tudo é exposto por um único endpoint JSON-RPC (/mcp). LLMs / Agentes podem: initialize -> readResource -> listTools -> callTool ... e assim por diante.

Início rápido (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

Nota de segurança: O transporte HTTP escuta em 127.0.0.1:8080 por padrão. Se você precisar expô-lo em uma rede, coloque-o atrás de um proxy reverso com autenticação.

Instalar via npm (transporte stdio)

npx duplicacy-mcp

Ou instale globalmente:

npm install -g duplicacy-mcp
duplicacy-mcp

Isso baixa o binário Go pré-compilado do GitHub Releases para sua plataforma e o executa com transporte stdio. Requer pelo menos um release publicado.

Build local

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

Configuração

Variável	Padrão	Descrição
`DUPLICACY_EXPORTER_URL`	`http://localhost:9750`	URL do exportador Prometheus do Duplicacy (sem barra final)
`LISTEN_ADDR`	`127.0.0.1:8080`	Endereço de escuta HTTP (Docker define `0.0.0.0:8080`)
`TRANSPORT`	(vazio = HTTP)	Defina como `stdio` para transporte stdio

Coloque-os em um arquivo .env (a partir de .env.example) ou defina-os no ambiente.

Testes

Testado com Inspector e atualmente está totalmente funcional. Antes de fazer um PR, certifique-se de que este servidor MCP se comporta bem por esse meio.

Exemplo de configuração para LLMs clientes

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

Créditos

Duplicacy -- backup em nuvem com deduplicação sem bloqueio

duplicacy-exporter -- exportador Prometheus para Duplicacy

MCP-GO -- implementação MCP moderna

GoReleaser -- releases multi-arquitetura sem dor

Mantenedores

@GeiserX.

Contribuindo

Sinta-se à vontade para contribuir! Abra uma issue ou envie PRs.

Duplicacy-MCP segue o Contributor Covenant Código de Conduta.

Outros Servidores MCP por GeiserX

cashpilot-mcp — Monitoramento de renda passiva
genieacs-mcp — Gerenciamento de dispositivos TR-069
lynxprompt-mcp — Blueprints de configuração de IA
pumperly-mcp — Preços de combustível e carregamento de veículos elétricos
telegram-archive-mcp — Arquivo de mensagens do Telegram

Projetos Relacionados

Projeto	Descrição
duplicacy-cli-cron	Automação de backup criptografado em armazenamento duplo baseada em Docker usando Duplicacy CLI
duplicacy-exporter	Exportador Prometheus em tempo real para backups Duplicacy
duplicacy-ha	Integração personalizada do Home Assistant para monitorar backups Duplicacy
duplicacy-container	Imagem de contêiner e Helm chart para executar Duplicacy no Kubernetes