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://progressandduplicacy://healthfor read-only browsing. - Tools
get_backup_status,get_backup_history,list_snapshotsandget_prune_status. - One JSON-RPC endpoint (
/mcp) over HTTP, or stdio throughnpx duplicacy-mcp. - Listens on
127.0.0.1:8080by 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»).
duplicacy-mcpclaude mcp add duplicacy-mcp -e 'DUPLICACY_EXPORTER_URL=http://localhost:9750' -- npx -y duplicacy-mcp@0.2.0
{
"mcpServers": {
"duplicacy-mcp": {
"command": "npx",
"args": [
"-y",
"duplicacy-mcp@0.2.0"
],
"env": {
"DUPLICACY_EXPORTER_URL": "http://localhost:9750"
}
}
}
}
متغيرات البيئة
DUPLICACY_EXPORTER_URLBase URL of duplicacy-exporter, for example http://localhost:9750
drumsergio/duplicacy-mcp:v0.2.0claude 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
{
"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_URLBase URL of duplicacy-exporter as the container reaches it, for example http://duplicacy-exporter:9750MCP_AUTH_TOKENإلزامي سري Bearer token clients must send; the image refuses to start without one. At least 16 characters, for example from openssl rand -hex 32MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call the endpoint cross-origin
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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://progressandduplicacy://healthfor read-only browsing. - Tools
get_backup_status,get_backup_history,list_snapshotsandget_prune_status. - One JSON-RPC endpoint (
/mcp) over HTTP, or stdio throughnpx duplicacy-mcp. - Listens on
127.0.0.1:8080by 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
- Getting started: Docker Compose, npm, local build, first run
- Configuration: environment variables, client config for stdio and HTTP
- Usage: resources and tools
- Development: testing with Inspector, credits, contributing
- Related projects: the Duplicacy family, other MCP servers, registry listings
Related projects
Part of the Duplicacy family: duplicacy-exporter, duplicacy-cli-cron, duplicacy-ha, duplicacy-container.
License
الأسئلة الشائعة
ما هو 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.