downloader-mcp

一个用于下载客户端的 MCP 服务器 —— SABnzbd (usenet) 和 qBittorrent (torrents) —— 打包为 Docker 容器。它是媒体管理 MCP（如 servarr-mcp）的配套工具。

每个客户端都是可选的：仅配置您实际运行的客户端，系统将仅注册这些工具。

工具

SABnzbd (usenet)

工具	描述
`sabnzbd_queue`	当前下载队列，包含速度和预计完成时间
`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。如果您在同一主机上运行两者，请在各自的配置中重新映射其中一个。

必须至少配置一个客户端，否则服务器将报错退出。

使用 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。