Duplicacy MCP

Monitorear el estado de las copias de seguridad y consultar métricas de Prometheus desde un exportador de Duplicacy

Documentación

Duplicacy-MCP

Un pequeño puente que lee métricas de respaldo de Duplicacy desde un exportador de Prometheus y las expone como un servidor MCP, permitiendo a los LLMs monitorear el estado, el progreso y la salud de los respaldos.

Lo que obtienes

Tipo	Para qué	MCP URI / ID de herramienta
Recursos	Explora el estado, progreso y salud de los respaldos en modo solo lectura	`duplicacy://status` `duplicacy://progress` `duplicacy://health`
Herramientas	Consulta el historial de respaldos, lista instantáneas y verifica el estado de poda	`get_backup_status` `get_backup_history` `list_snapshots` `get_prune_status`

Todo se expone a través de un único endpoint JSON-RPC (/mcp). Los LLMs / Agentes pueden: initialize -> readResource -> listTools -> callTool ... y así sucesivamente.

Inicio 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 seguridad: El transporte HTTP escucha en 127.0.0.1:8080 por defecto. Si necesitas exponerlo en una red, colócalo detrás de un proxy inverso con autenticación.

Instalación mediante npm (transporte stdio)

npx duplicacy-mcp

O instalar globalmente:

npm install -g duplicacy-mcp
duplicacy-mcp

Esto descarga el binario Go precompilado desde GitHub Releases para tu plataforma y lo ejecuta con transporte stdio. Requiere al menos una versión publicada.

Compilación 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

Configuración

Variable	Predeterminado	Descripción
`DUPLICACY_EXPORTER_URL`	`http://localhost:9750`	URL del exportador Prometheus de Duplicacy (sin / final)
`LISTEN_ADDR`	`127.0.0.1:8080`	Dirección de escucha HTTP (Docker establece `0.0.0.0:8080`)
`TRANSPORT`	(vacío = HTTP)	Establecer a `stdio` para transporte stdio

Colócalas en un archivo .env (desde .env.example) o configúralas en el entorno.

Pruebas

Probado con Inspector y actualmente funciona completamente. Antes de hacer un PR, asegúrate de que este servidor MCP se comporte bien a través de este medio.

Ejemplo de configuración 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 -- respaldo en la nube con deduplicación sin bloqueos

duplicacy-exporter -- Exportador Prometheus para Duplicacy

MCP-GO -- implementación MCP moderna

GoReleaser -- lanzamientos multi-arquitectura sin complicaciones

Mantenedores

@GeiserX.

Contribuciones

¡Siéntete libre de participar! Abre un issue o envía PRs.

Duplicacy-MCP sigue el Contributor Covenant Código de Conducta.

Otros servidores MCP de GeiserX

cashpilot-mcp — Monitoreo de ingresos pasivos
genieacs-mcp — Gestión de dispositivos TR-069
lynxprompt-mcp — Planos de configuración de IA
pumperly-mcp — Precios de combustible y carga de vehículos eléctricos
telegram-archive-mcp — Archivo de mensajes de Telegram

Proyectos relacionados

Proyecto	Descripción
duplicacy-cli-cron	Automatización de respaldos cifrados de doble almacenamiento basada en Docker usando Duplicacy CLI
duplicacy-exporter	Exportador Prometheus en tiempo real para respaldos de Duplicacy
duplicacy-ha	Integración personalizada de Home Assistant para monitorear respaldos de Duplicacy
duplicacy-container	Imagen de contenedor y chart de Helm para ejecutar Duplicacy en Kubernetes