downloader-mcp

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

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

Инструменты

SABnzbd (usenet)

qBittorrent (торренты)

Related MCP server: NZBGet MCP Server

Конфигурация

Для включения каждого клиента требуется полный блок конфигурации; частичная конфигурация молча отключает клиента.

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.