downloader-mcp

Docker 컨테이너로 패키징된 다운로드 클라이언트용 MCP 서버입니다. servarr-mcp와 같은 미디어 관리 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: 설정 → 일반 → 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

보안

컨테이너는 루트가 아닌 사용자(mcp)로 실행됩니다.
자격 증명은 환경 변수를 통해 전달되며 이미지에 포함되지 않습니다.
.githooks/pre-commit은 gitleaks(비밀 정보) 및 PII 패턴 검사(사용자 홈 경로, 개인 도메인 이메일)를 실행합니다. 클론당 한 번 활성화하십시오: git config core.hooksPath .githooks.