iptorrents MCP 서버

iptorrents.com에서 토렌트를 검색하고 다운로드하기 위한 MCP(Model Context Protocol) 서버입니다.

기능

• 필터링 및 정렬을 통한 토렌트 검색

• 브라우저 쿠키 기반 인증 (Cloudflare Turnstile로 인해 자동 로그인 불가)

• 토렌트 메타데이터 추출 (시더, 리처, 크기, 카테고리 등)

• Freeleech 감지

설치

pip install -e .

사용법

iptorrents 인증을 위한 환경 변수를 설정합니다:

export IPTORRENTS_UID="<your_uid_cookie>"
export IPTORRENTS_PASS="<your_pass_cookie>"
export IPTORRENTS_CF_CLEARANCE="<cf_clearance_if_needed>"

iptorrents.com에서 쿠키를 가져오는 방법:

1. 브라우저에서 https://iptorrents.com을 엽니다.

2. 로그인합니다.

3. 개발자 도구(F12)를 엽니다.

4. 저장소(Storage) → 쿠키(Cookies) → iptorrents.com으로 이동합니다.

5. uid, pass, cf_clearance 값을 복사합니다.

서버 실행:

python -m iptorrents_mcp.main

도구

search_iptorrents

iptorrents.com에서 토렌트 검색

매개변수:

• query (문자열, 필수): 검색어

• limit (정수): 최대 결과 수 (기본값: 10)

• sort (문자열): 정렬 필드 (seeders, leechers, size, downloads, name, age)

예시:

search_iptorrents("The Office", limit=5, sort="seeders")

참고

https://github.com/evanpurkhiser/iptorrents-cli 에서 영감을 받았습니다. 올바른 iptorrents API 상호작용을 위한 참조 구현체입니다.