downloader-mcp

MCP-сервер (MCP) для клиентов загрузки — SABnzbd (usenet) и qBittorrent (торренты) — упакованный в виде Docker-контейнера. Дополнение к MCP для управления медиа, таким как servarr-mcp.

Каждый клиент является опциональным: настройте только те, которые вы действительно используете, и будут зарегистрированы только соответствующие инструменты.

Инструменты

SABnzbd (usenet)

Инструмент	Описание
`sabnzbd_queue`	Текущая очередь загрузки со скоростями и временем завершения
`sabnzbd_history`	Недавняя история (сначала новые)
`sabnzbd_categories`	Настроенные категории
`sabnzbd_version`	Информация о версии SABnzbd

qBittorrent (торренты)

Инструмент	Описание
`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: Config → General → API Key
qBittorrent: Tools → Options → 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.