duplicati-mcp

Duplicati MCP Server

LLM から Duplicati のバックアップを管理するための MCP（Model Context Protocol）サーバーです。

フランス語版 / French version

アーキテクチャ

このサーバーは Duplicati REST API をラップし、MCP プロトコル経由で公開します。次の 2 つのトランスポートをサポートしています。

• stdio — Claude Code を使ったローカル利用向け（ネットワークやポートは不要）
• Streamable HTTP — Docker でのデプロイ向け。ネットワーク経由でアクセスできます

はじめに

Claude Code を使ったローカル利用（stdio）

最も簡単な方法です。プロジェクトルートにある .mcp.json がすべてを処理します。

# Install uv if needed
brew install uv

# Claude Code will auto-detect .mcp.json and launch the server

.mcp.json に Duplicati の URL とパスワードを設定します。

{
  "mcpServers": {
    "duplicati": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "duplicati-mcp"],
      "env": {
        "DUPLICATI_URL": "http://localhost:8200",
        "DUPLICATI_PASSWORD": "your-password",
        "DUPLICATI_READONLY": ""
      }
    }
  }
}

Docker Compose を使う（Docker Hub イメージ）

# Edit DUPLICATI_URL and DUPLICATI_PASSWORD in docker-compose.yml, then:
docker compose up -d

Docker Compose を使う（ローカルビルド）

# Edit docker-compose.yml: comment out `image:` and uncomment `build: .`
docker compose up -d --build

Docker を直接使う

docker run -d \
  --name duplicati-mcp-server \
  -p 3000:3000 \
  -e DUPLICATI_URL=http://your-duplicati-host:8200 \
  -e DUPLICATI_PASSWORD=your-password \
  kcofoni/duplicati-mcp:latest

動作確認

# Check that the server is running
docker logs duplicati-mcp-server

# Test the MCP endpoint
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

クライアントの設定

Claude Code — ローカル（stdio）

Docker を使わずにローカルで利用する場合は、プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "duplicati": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "duplicati-mcp"],
      "env": {
        "DUPLICATI_URL": "http://localhost:8200",
        "DUPLICATI_READONLY": ""
      }
    }
  }
}

認証情報はプロジェクトルートの .env ファイルから読み込まれます（はじめにを参照）。

Claude Code — Docker／リモート（HTTP）

.mcp.json に追加します。

{
  "mcpServers": {
    "duplicati": {
      "type": "http",
      "url": "http://your-host:3000/mcp"
    }
  }
}

Claude Desktop

Claude Desktop では、HTTP サーバーへのブリッジとして mcp-proxy が必要です。設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "duplicati": {
      "command": "uvx",
      "args": ["mcp-proxy", "--transport", "streamablehttp", "http://your-host:3000/mcp"]
    }
  }
}

利用可能なツール

接続すると、LLM は次のツールを利用できます。

バックアップジョブ

1. list_backups — ID、名前、前回の実行日時、結果とともに、設定済みのすべてのジョブを一覧表示します
2. get_backup — 特定のジョブの詳細情報を取得します
3. run_backup — バックアップジョブをただちに実行します
4. abort_backup — ジョブで現在実行中のバックアップを中止します

ステータスと進捗

5. get_progress — アクティブなバックアップタスクの進捗状況（フェーズ、％、ファイル数）をリアルタイムで取得します
6. get_server_status — Duplicati サーバーの状態、バージョン、アクティブなタスクを取得します

設定

7. export_backup_config — ジョブの設定を JSON としてエクスポートします
8. update_backup_config — 既存のジョブ設定をその場で更新します（ソース、設定、スケジュールなどを変更する場合は export_backup_config と組み合わせて使用します）
9. import_backup_config — JSON からジョブ設定をインポートします（新しいジョブを作成します）

履歴と診断（SQLite — DUPLICATI_DB_PATH が必要）

10. db_get_backup_metadata — ローカルデータベースから詳細なメタデータを取得します。前回の実行日時、所要時間、ファイル数、クォータ使用量、前回のエラーが含まれます
11. db_get_backup_schedule — バックアップジョブのスケジュール設定を取得します
12. db_list_errors — ジョブによる絞り込みも可能な、最近のエラーログ項目を一覧表示します
13. db_list_notifications — システム通知（更新アラートなど）を一覧表示します
14. db_get_backup_options — ジョブの設定オプション（圧縮、保持ポリシーなど）を取得します。パスフレーズは除外されます
15. db_list_operations — タイムスタンプ付きで、ジョブの操作履歴（Backup、Restore、List など）を一覧表示します
16. db_get_operation_log — 特定の操作の全結果と統計情報を取得します
17. db_list_filesets — ジョブで利用できる復元ポイント（バックアップバージョン）を一覧表示します

プロンプトの例

サーバーを LLM に接続したら、以下のプロンプトを使用できます。

全般的なステータス

• 「Duplicati にはどのようなバックアップジョブが設定されていますか？」
• 「最後に実行されたバックアップは何で、結果はどうでしたか？」
• 「現在、バックアップは実行中ですか？」

履歴と統計 (requires DUPLICATI_DB_PATH)

• 「バックアップジョブ 2 の直近 10 件の操作を表示してください」
• 「最近のバックアップの平均実行時間はどのくらいですか？」
• 「ここ数週間でバックアップにエラーは発生しましたか？」
• 「バックアップされているファイル数と、保存先の合計サイズを教えてください」

復元ポイント (requires DUPLICATI_DB_PATH)

• 「バックアップジョブで利用できる復元ポイントは何ですか？」
• 「復元に利用できる最も古いバックアップは何ですか？」

設定 (requires DUPLICATI_DB_PATH)

• 「バックアップジョブにはどのような保持ポリシーが設定されていますか？」
• 「どのような圧縮オプションと暗号化オプションが使用されていますか？」

診断 (requires DUPLICATI_DB_PATH)

• 「Duplicati に保留中のシステム通知はありますか？」
• 「最近 Duplicati でエラーは発生しましたか？発生した場合、どのようなエラーですか？」
• 「最後のバックアップを分析して、すべて問題なく完了したか教えてください」

自由形式 (複数のツールを組み合わせます)

• 「Duplicati のバックアップに関する包括的な健全性レポートを作成してください」

環境変数

変数	デフォルト	説明
DUPLICATI_URL	http://localhost:8200	Duplicati インスタンスの URL
DUPLICATI_PASSWORD	(empty)	Duplicati のウェブインターフェースのパスワード（設定されていない場合は空のままにします）
DUPLICATI_READONLY	(empty)	書き込み操作を無効にするには、true、1、または yes を設定します
DUPLICATI_DB_PATH	(empty)	Duplicati-server.sqlite へのパス。SQLite を利用する履歴ツールが有効になります
MCP_TRANSPORT	stdio	トランスポート：stdio または streamable-http
MCP_PORT	3000	Streamable HTTP トランスポートのポート

読み取り専用モード

DUPLICATI_READONLY=true にすると、run_backup、abort_backup、update_backup_config、import_backup_config が無効になります。すべての読み取りツールは引き続き使用できます。変更のリスクを伴わずにバックアップ設定を安全に確認、分析するのに便利です。

SQLite アクセス

DUPLICATI_DB_PATH を設定すると、Duplicati の SQLite データベースから直接読み取る db_* ツールが有効になります。アクセスは完全に読み取り専用です。データベースは読み取り専用モードで開かれ、クエリを実行する前に SQLite Online Backup API を介してメモリにコピーされます。稼働中の Duplicati データベースがロックされたり変更されたりすることはありません。

ローカルでの使用 — お使いのマシン上のサーバーデータベースを指定します：

DUPLICATI_DB_PATH=/path/to/duplicati/config/Duplicati-server.sqlite

Docker — Duplicati の設定ディレクトリを読み取り専用ボリュームとして共有します。docker-compose.yml では次のように設定します：

services:
  duplicati-mcp:
    # ...
    volumes:
      - duplicati_config:/duplicati-config:ro   # named volume (recommended)
      # or: - /srv/duplicati/config:/duplicati-config:ro  # bind mount
    environment:
      - DUPLICATI_DB_PATH=/duplicati-config/Duplicati-server.sqlite

volumes:
  duplicati_config:   # must be the same volume used by the Duplicati container

Docker Hub

• リポジトリ：kcofoni/duplicati-mcp
• 最新のタグ：kcofoni/duplicati-mcp:latest

docker pull kcofoni/duplicati-mcp:latest

開発

ファイル構成

duplicati-mcp/
├── src/
│   └── duplicati_mcp/
│       ├── __init__.py
│       ├── __main__.py
│       ├── client.py        # Duplicati REST API client
│       ├── db.py            # Read-only SQLite access (server DB + per-backup DBs)
│       └── server.py        # FastMCP server and tools
├── mcp-publication/         # MCP registry publication files
├── requirements.txt         # Python dependencies
├── pyproject.toml           # Project metadata
├── Dockerfile
├── docker-compose.yml
├── .mcp.json                # Claude Code local config (stdio)
├── test_server.sh           # Docker container smoke test
├── test_mcp.py              # MCP protocol test
├── README.md                # This file (English)
└── README_fr.md             # French documentation

テストの実行

# Smoke test (requires running Docker container)
./test_server.sh

# MCP protocol test (requires running server)
python test_mcp.py
python test_mcp.py localhost:3000

ツールの対話的なテスト（ローカル）

uv run mcp dev src/duplicati_mcp/server.py

トラブルシューティング

Duplicati に接続できない

コンテナから DUPLICATI_URL に到達できることを確認してください。両方が Docker で動作している場合は、同じネットワークに接続し、サービス名をホスト名として使用してください。

認証に失敗する

DUPLICATI_PASSWORD が Duplicati のウェブインターフェースに設定されているパスワードと一致することを確認してください。パスワードが設定されていない場合は、空のままにします。

MCP エンドポイントが応答しない

docker ps | grep duplicati-mcp-server
docker logs duplicati-mcp-server

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。