Duplicacy MCP

السجل الرسمي الصحة

MCP server for Duplicacy: backup health, status and Prometheus metrics from duplicacy-exporter

ماذا يمكنك أن تفعل مع Duplicacy MCP؟

  • Reads the metrics of duplicacy-exporter and serves them over MCP.
  • Resources duplicacy://status, duplicacy://progress and duplicacy://health for read-only browsing.
  • Tools get_backup_status, get_backup_history, list_snapshots and get_prune_status.
  • One JSON-RPC endpoint (/mcp) over HTTP, or stdio through npx duplicacy-mcp.
  • Listens on 127.0.0.1:8080 by 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package duplicacy-mcp
Claude Code
claude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://localhost:9750' -- npx -y duplicacy-mcp@0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "duplicacy-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "duplicacy-mcp@0.2.0"
            ],
            "env": {
                "DUPLICACY_EXPORTER_URL": "http://localhost:9750"
            }
        }
    }
}

متغيرات البيئة

  • DUPLICACY_EXPORTER_URL Base URL of duplicacy-exporter, for example http://localhost:9750
OCI package drumsergio/duplicacy-mcp:v0.2.0
Claude Code
claude 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
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • DUPLICACY_EXPORTER_URL Base URL of duplicacy-exporter as the container reaches it, for example http://duplicacy-exporter:9750
  • MCP_AUTH_TOKEN إلزامي سري Bearer token clients must send; the image refuses to start without one. At least 16 characters, for example from openssl rand -hex 32
  • MCP_ALLOWED_ORIGINS Comma-separated browser origins allowed to call the endpoint cross-origin

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Duplicacy MCP
  2. Features
  3. Quick start
  4. Documentation
  5. Related projects
  6. License

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://progress and duplicacy://health for read-only browsing.
  • Tools get_backup_status, get_backup_history, list_snapshots and get_prune_status.
  • One JSON-RPC endpoint (/mcp) over HTTP, or stdio through npx duplicacy-mcp.
  • Listens on 127.0.0.1:8080 by 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

Part of the Duplicacy family: duplicacy-exporter, duplicacy-cli-cron, duplicacy-ha, duplicacy-container.

License

GPL-3.0-or-later

الأسئلة الشائعة

ما هو Duplicacy MCP؟

MCP server for Duplicacy: backup health, status and Prometheus metrics from duplicacy-exporter

كيف أثبّت Duplicacy MCP؟

يعمل على جهازك. في Claude Code: claude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://localhost:9750' -- npx -y duplicacy-mcp@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Duplicacy MCP إلى مفتاح API؟

نعم. يتطلب MCP_AUTH_TOKEN، وتضبطها في إعداداته.

هل Duplicacy MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.

من يصون Duplicacy MCP؟

ينشره GeiserX. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.