{"id":47777074,"url":"https://github.com/geiserx/duplicacy-mcp","last_synced_at":"2026-04-03T12:03:27.773Z","repository":{"id":348526438,"uuid":"1198347360","full_name":"GeiserX/duplicacy-mcp","owner":"GeiserX","description":"MCP Server for Duplicacy — monitor backup status, progress, and health from Prometheus exporter via MCP","archived":false,"fork":false,"pushed_at":"2026-04-01T15:15:12.000Z","size":8981,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-01T15:29:30.439Z","etag":null,"topics":["ai-tools","backup","backup-monitoring","deduplication","docker","duplicacy","exporter","go","golang","homelab","json-rpc","llm","mcp","mcp-server","metrics","model-context-protocol","monitoring","prometheus","self-hosted","stdio"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GeiserX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"geiserx","patreon":"geiser","buy_me_a_coffee":"geiser","thanks_dev":"u/gh/geiserx"}},"created_at":"2026-04-01T10:40:21.000Z","updated_at":"2026-04-01T15:15:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GeiserX/duplicacy-mcp","commit_stats":null,"previous_names":["geiserx/duplicacy-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/GeiserX/duplicacy-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fduplicacy-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fduplicacy-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fduplicacy-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fduplicacy-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeiserX","download_url":"https://codeload.github.com/GeiserX/duplicacy-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fduplicacy-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31349561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T08:03:20.796Z","status":"ssl_error","status_checked_at":"2026-04-03T08:00:37.834Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","backup","backup-monitoring","deduplication","docker","duplicacy","exporter","go","golang","homelab","json-rpc","llm","mcp","mcp-server","metrics","model-context-protocol","monitoring","prometheus","self-hosted","stdio"],"created_at":"2026-04-03T12:03:27.291Z","updated_at":"2026-04-03T12:03:27.765Z","avatar_url":"https://github.com/GeiserX.png","language":"Go","funding_links":["https://github.com/sponsors/geiserx","https://patreon.com/geiser","https://buymeacoffee.com/geiser","https://thanks.dev/u/gh/geiserx"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eDuplicacy-MCP\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/duplicacy-mcp\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/duplicacy-mcp?style=flat-square\u0026logo=npm\" alt=\"npm\"/\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Go-1.24-blue?style=flat-square\u0026logo=go\u0026logoColor=white\" alt=\"Go\"/\u003e\n  \u003ca href=\"https://hub.docker.com/r/drumsergio/duplicacy-mcp\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/drumsergio/duplicacy-mcp?style=flat-square\u0026logo=docker\" alt=\"Docker Pulls\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/GeiserX/duplicacy-mcp/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/GeiserX/duplicacy-mcp?style=flat-square\u0026logo=github\" alt=\"GitHub Stars\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/GeiserX/duplicacy-mcp/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/GeiserX/duplicacy-mcp?style=flat-square\" alt=\"License\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://registry.modelcontextprotocol.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/MCP-Official%20Registry-E6522C?style=flat-square\" alt=\"Official MCP Registry\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://glama.ai/mcp/servers/GeiserX/duplicacy-mcp\"\u003e\u003cimg src=\"https://glama.ai/mcp/servers/GeiserX/duplicacy-mcp/badges/score.svg\" alt=\"Glama MCP Server\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://mcpservers.org/servers/geiserx/duplicacy-mcp\"\u003e\u003cimg src=\"https://img.shields.io/badge/MCPServers.org-listed-green?style=flat-square\" alt=\"MCPServers.org\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://mcp.so/server/duplicacy-mcp\"\u003e\u003cimg src=\"https://img.shields.io/badge/mcp.so-listed-blue?style=flat-square\" alt=\"mcp.so\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/toolsdk-ai/toolsdk-mcp-registry\"\u003e\u003cimg src=\"https://img.shields.io/badge/ToolSDK-Registry-orange?style=flat-square\" alt=\"ToolSDK Registry\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eA 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.\u003c/strong\u003e\u003c/p\u003e\n\n---\n\n## What you get\n\n| Type          | What for                                                   | MCP URI / Tool id                |\n|---------------|------------------------------------------------------------|----------------------------------|\n| **Resources** | Browse backup status, progress, and health read-only       | `duplicacy://status`\u003cbr\u003e`duplicacy://progress`\u003cbr\u003e`duplicacy://health` |\n| **Tools**     | Query backup history, list snapshots, and check prune status | `get_backup_status`\u003cbr\u003e`get_backup_history`\u003cbr\u003e`list_snapshots`\u003cbr\u003e`get_prune_status` |\n\nEverything is exposed over a single JSON-RPC endpoint (`/mcp`).\nLLMs / Agents can: `initialize` -\u003e `readResource` -\u003e `listTools` -\u003e `callTool` ... and so on.\n\n---\n\n## Quick-start (Docker Compose)\n\n```yaml\nservices:\n  duplicacy-mcp:\n    image: drumsergio/duplicacy-mcp:latest\n    ports:\n      - \"127.0.0.1:8080:8080\"\n    environment:\n      - DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750\n```\n\n\u003e **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.\n\n## Install via npm (stdio transport)\n\n```sh\nnpx duplicacy-mcp\n```\n\nOr install globally:\n\n```sh\nnpm install -g duplicacy-mcp\nduplicacy-mcp\n```\n\nThis downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one [published release](https://github.com/GeiserX/duplicacy-mcp/releases).\n\n## Local build\n\n```sh\ngit clone https://github.com/GeiserX/duplicacy-mcp\ncd duplicacy-mcp\n\n# (optional) create .env from the sample\ncp .env.example .env \u0026\u0026 $EDITOR .env\n\ngo run ./cmd/server\n```\n\n## Configuration\n\n| Variable                 | Default                    | Description                                          |\n|--------------------------|----------------------------|------------------------------------------------------|\n| `DUPLICACY_EXPORTER_URL` | `http://localhost:9750`    | Duplicacy Prometheus exporter URL (without trailing /)|\n| `LISTEN_ADDR`            | `127.0.0.1:8080`           | HTTP listen address (Docker sets `0.0.0.0:8080`)     |\n| `TRANSPORT`              | _(empty = HTTP)_           | Set to `stdio` for stdio transport                   |\n\nPut them in a `.env` file (from `.env.example`) or set them in the environment.\n\n## Testing\n\nTested with [Inspector](https://modelcontextprotocol.io/docs/tools/inspector) and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.\n\n## Example configuration for client LLMs\n\n```json\n{\n  \"schema_version\": \"v1\",\n  \"name_for_human\": \"Duplicacy-MCP\",\n  \"name_for_model\": \"duplicacy_mcp\",\n  \"description_for_human\": \"Monitor Duplicacy backup status, progress, and health via Prometheus metrics.\",\n  \"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.\",\n  \"auth\": { \"type\": \"none\" },\n  \"api\": {\n    \"type\": \"jsonrpc-mcp\",\n    \"url\":  \"http://localhost:8080/mcp\",\n    \"init_method\": \"initialize\",\n    \"session_header\": \"Mcp-Session-Id\"\n  },\n  \"contact_email\": \"acsdesk@protonmail.com\",\n  \"legal_info_url\": \"https://github.com/GeiserX/duplicacy-mcp/blob/main/LICENSE\"\n}\n```\n\n## Credits\n\n[Duplicacy](https://duplicacy.com/) -- lock-free deduplication cloud backup\n\n[duplicacy-exporter](https://github.com/jmgilman/duplicacy-exporter) -- Prometheus exporter for Duplicacy\n\n[MCP-GO](https://github.com/mark3labs/mcp-go) -- modern MCP implementation\n\n[GoReleaser](https://goreleaser.com/) -- painless multi-arch releases\n\n## Maintainers\n\n[@GeiserX](https://github.com/GeiserX).\n\n## Contributing\n\nFeel free to dive in! [Open an issue](https://github.com/GeiserX/duplicacy-mcp/issues/new) or submit PRs.\n\nDuplicacy-MCP follows the [Contributor Covenant](http://contributor-covenant.org/version/2/1/) Code of Conduct.\n\n## Other MCP Servers by GeiserX\n\n- [cashpilot-mcp](https://github.com/GeiserX/cashpilot-mcp) — Passive income monitoring\n- [genieacs-mcp](https://github.com/GeiserX/genieacs-mcp) — TR-069 device management\n- [lynxprompt-mcp](https://github.com/GeiserX/lynxprompt-mcp) — AI configuration blueprints\n- [pumperly-mcp](https://github.com/GeiserX/pumperly-mcp) — Fuel and EV charging prices\n- [telegram-archive-mcp](https://github.com/GeiserX/telegram-archive-mcp) — Telegram message archive\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fduplicacy-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeiserx%2Fduplicacy-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fduplicacy-mcp/lists"}