Duplicacy Mcp

Duplicacy MCP

Prometheus エクスポーターから Duplicacy のバックアップメトリクスを読み取り、MCP サーバーとして公開する小さなブリッジです。LLM によるバックアップの状態、進行状況、健全性の監視を可能にします。

機能

• duplicacy-exporter のメトリクスを読み取り、MCP 経由で提供します。
• 1 回の呼び出しで「バックアップは正常ですか？」に回答します。get_backup_overview は各バックアップに判定（正常、実行中、古い、未実行、失敗）と理由を返します。
• MCP 2026-07-28（server/discover、ステートレスリクエスト）と、それ以前のすべてのリビジョン（initialize ハンドシェイクを使う 2024-11-05 まで）に、同じバイナリで対応します。stdio と Streamable HTTP の両方で動作します。旧式のハンドシェイクを使い続けるクライアントも引き続き動作します。
• 設計上、読み取り専用です。すべてのツールとリソースはエクスポーターから読み取るだけなので、読み取り専用フラグの設定は不要です。すべてのツールに readOnlyHint、タイトル、出力スキーマ、構造化された結果が含まれます。
• HTTP はデフォルトで 127.0.0.1:8080 で待ち受けます。それ以外のアドレスでは、ベアラートークンがないと起動を拒否し、クロスオリジンのブラウザーリクエストを拒否して、リクエスト本文のサイズを制限します。
• GoReleaser による複数プラットフォーム向け Go バイナリ、Docker イメージ、npm ラッパーとして提供されます。

ツールとリソース

ツール	回答する内容
get_backup_overview	1 回の呼び出しで全バックアップの健全性を確認します。判定、理由、最後に成功したバックアップからの経過時間を返します。max_age_hours（デフォルトは 26）で、バックアップを古いと判定するまでの時間を設定します。
list_snapshots	フィルター値として使用できる、すべてのスナップショット ID、ストレージの保存先、マシンを返します。
get_backup_status	スナップショット 1 つの状態と最終実行の詳細を、ストレージの保存先とマシンごとに返します。
get_backup_history	スナップショット 1 つの最後に完了した実行を返します。エクスポーターは最後の実行のみを保持します。
get_prune_status	ストレージの保存先ごとに、プルーニングの実行中かどうかと、最後に成功した日時を返します。
get_storage_usage	エクスポーターのストレージポーラーから、ストレージサイズとチャンク数、およびスナップショットごとのリビジョン数を返します。

リソース：duplicacy://status、duplicacy://progress、duplicacy://health。パラメーターと出力フィールドについては、使用方法をご覧ください。

インストール

npm パッケージは stdio 経由でサーバーを実行します。DUPLICACY_EXPORTER_URL にエクスポーターを設定してください。

Claude Code

claude mcp add --transport stdio --env DUPLICACY_EXPORTER_URL=http://localhost:9750 duplicacy -- npx -y duplicacy-mcp

Claude Desktop（claude_desktop_config.json）および Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "duplicacy": {
      "command": "npx",
      "args": ["-y", "duplicacy-mcp"],
      "env": { "DUPLICACY_EXPORTER_URL": "http://localhost:9750" }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "duplicacy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "duplicacy-mcp"],
      "env": { "DUPLICACY_EXPORTER_URL": "http://localhost:9750" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.duplicacy]
command = "npx"
args = ["-y", "duplicacy-mcp"]
env = { DUPLICACY_EXPORTER_URL = "http://localhost:9750" }

npm 12、pnpm、Bun ではインストールスクリプトがスキップされるため、ラッパーが初回起動時にバイナリをダウンロードして検証します。0.1.2 以前のバージョンはインストールスクリプトのみに依存していました。npm 12 で実行する場合は、npx -y --allow-scripts=duplicacy-mcp duplicacy-mcp を使用してください。

Docker（Streamable HTTP）

export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
docker run -d -p 127.0.0.1:8080:8080 -e MCP_AUTH_TOKEN \
  -e DUPLICACY_EXPORTER_URL=http://duplicacy-exporter:9750 drumsergio/duplicacy-mcp:v0.2.0
claude mcp add --transport http duplicacy http://127.0.0.1:8080/mcp --header "Authorization: Bearer $MCP_AUTH_TOKEN"

コンテナ内でイメージは 0.0.0.0:8080 をリッスンするため、MCP_AUTH_TOKEN を設定するか、認証を行うリバースプロキシの背後で MCP_ALLOW_UNAUTHENTICATED=true を設定しないと起動しません。Compose、グローバル npm インストール、ローカルビルドについてははじめにを、すべての変数については設定を参照してください。

ドキュメント

• はじめに：Docker Compose、npm、ローカルビルド、初回実行
• 設定：環境変数、HTTP セキュリティ、stdio および HTTP 用のクライアント設定
• 使い方：ツール、パラメーター、出力フィールド、リソース
• 開発：Inspector によるテスト、クレジット、コントリビューション
• 関連プロジェクト：Duplicacy ファミリー、その他の MCP サーバー、レジストリー掲載情報

関連プロジェクト

Duplicacy ファミリーの一部です：duplicacy-exporter、duplicacy-cli-cron、duplicacy-ha、duplicacy-container。

ライセンス

GPL-3.0-or-later