downloader-mcp

ダウンロードクライアント（SABnzbd (usenet) および qBittorrent (torrents)）用の MCP サーバーで、Docker コンテナとしてパッケージ化されています。servarr-mcp のようなメディア管理 MCP のコンパニオンです。

各クライアントはオプションです。実際に実行しているものだけを設定すれば、そのツールのみが登録されます。

ツール

SABnzbd (usenet)

ツール	説明
`sabnzbd_queue`	速度と ETA を含む現在のダウンロードキュー
`sabnzbd_history`	最近の履歴（新しい順）
`sabnzbd_categories`	設定されたカテゴリ
`sabnzbd_version`	SABnzbd のバージョン情報

qBittorrent (torrents)

ツール	説明
`qbittorrent_list_torrents`	トレントの一覧（オプションでステータスフィルタリング可能）
`qbittorrent_get_torrent`	info-hash によるトレントの詳細
`qbittorrent_torrent_files`	トレント内のファイル
`qbittorrent_transfer_info`	グローバル転送統計
`qbittorrent_categories`	設定されたカテゴリ
`qbittorrent_version`	qBittorrent アプリケーションのバージョン

設定

各クライアントを有効にするには、完全な設定ブロックが必要です。設定が不完全な場合、クライアントはサイレントに無効化されます。

クライアント	必要な環境変数	デフォルトポート
SABnzbd	`SABNZBD_URL`, `SABNZBD_API_KEY`	8080
qBittorrent	`QBITTORRENT_URL`, `QBITTORRENT_USERNAME`, `QBITTORRENT_PASSWORD`	8080

API キーや認証情報は各アプリの設定から確認できます：

SABnzbd: 設定 → 一般 → API キー
qBittorrent: ツール → オプション → Web UI (デフォルトユーザー admin)

注: SABnzbd と qBittorrent はどちらもデフォルトでポート 8080 を使用します。同じホストで両方を実行する場合は、いずれかの設定でポートを再マッピングしてください。

少なくとも 1 つのクライアントを設定する必要があります。設定がない場合、サーバーはエラーで終了します。

Docker での実行

docker build -t downloader-mcp .
docker run -i --rm \
  -e SABNZBD_URL=http://192.168.1.50:8080 -e SABNZBD_API_KEY=... \
  -e QBITTORRENT_URL=http://192.168.1.50:8081 \
  -e QBITTORRENT_USERNAME=admin -e QBITTORRENT_PASSWORD=... \
  downloader-mcp

Claude Desktop での使用

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "downloader": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SABNZBD_URL", "-e", "SABNZBD_API_KEY",
        "-e", "QBITTORRENT_URL",
        "-e", "QBITTORRENT_USERNAME", "-e", "QBITTORRENT_PASSWORD",
        "downloader-mcp"
      ],
      "env": {
        "SABNZBD_URL": "http://192.168.1.50:8080",
        "SABNZBD_API_KEY": "...",
        "QBITTORRENT_URL": "http://192.168.1.50:8081",
        "QBITTORRENT_USERNAME": "admin",
        "QBITTORRENT_PASSWORD": "..."
      }
    }
  }
}

実行しないクライアントの -e/env エントリは削除してください。

ローカル開発

npm install
cp .env.example .env  # then edit
SABNZBD_URL=... SABNZBD_API_KEY=... npm run dev

セキュリティ

コンテナは非 root ユーザー (mcp) として実行されます。
認証情報は環境変数を介して渡され、イメージに組み込まれることはありません。
.githooks/pre-commit は gitleaks (シークレット) と PII パターンチェック (ユーザーホームパス、個人ドメインメール) を実行します。クローンごとに一度有効化してください：git config core.hooksPath .githooks。