rutracker_mcp

MCP 서버 for RuTracker — Claude (Desktop / Code / API) 및 모든 MCP 호환 클라이언트에서 직접 토렌트 검색 및 .torrent 파일 다운로드를 제공합니다.

⚠️ 이것은 포크입니다. CarrySauce/rutracker-mcp-server (이것은 다시 notnooblord/rutracker-mcp-server의 포크)를 기반으로 하며, FastMCP + py-rutracker-client를 사용합니다. 원래 MCP 서버(server.py)와 도구 세트는 변경 없이 유지됩니다. 이 포크는 러시아 연방에서의 접근을 위한 차단 우회를 추가합니다.

포크의 이유

원본은 login.php에 일반 POST로 로그인합니다. 러시아 환경에서는 작동하지 않습니다:

1. Cloudflare Managed Challenge. RuTracker는 Cloudflare의 안티봇 검사로 보호됩니다. 단순 HTTP 클라이언트(aiohttp)는 이를 통과하지 못하고 403을 받습니다.

2. РКН 차단 + cf_clearance의 IP 바인딩. 사이트는 러시아 ISP에서 차단되어 있으며, Cloudflare 토큰은 IP 및 User-Agent에 바인딩됩니다.

추가된 내용

자세한 내용은 docs/USER_GUIDE_RU.md (사람용) 및 AGENTS.md (AI 에이전트용)를 참조하세요.

Related MCP server: RuTracker MCP Server

작동 방식

get_cookies_pr.py  --(patchright + настоящий Chrome через VPN)-->  проходит Cloudflare, логинится
                   --> cookies.json (bb_session, cf_clearance, User-Agent)

server.py (MCP) --> CookieRuTrackerClient:
                    • вливает cookies.json в aiohttp-сессию (без login.php)
                    • биндит сокет к IP TAP-адаптера VPN (тот же IP, что у Chrome)
                    • тот же User-Agent -> cf_clearance валиден

요구 사항

• Python 3.13+

• RuTracker 계정

• TAP 어댑터가 있는 VPN (ZoogVPN에서 테스트됨). 러시아 연방에서는 필수입니다.

• Google Chrome (patchright를 통한 쿠키 획득용)

빠른 시작

git clone https://github.com/Lqueed/rutracker_mcp.git
cd rutracker_mcp
python -m venv .venv
.venv/Scripts/python -m pip install -r requirements.txt
.venv/Scripts/python -m pip install patchright psutil
.venv/Scripts/python -m patchright install chromium

cp .env.example .env          # вписать RUTRACKER_LOGIN и RUTRACKER_PASSWORD
# включить VPN, затем добыть cookie:
.venv/Scripts/python get_cookies_pr.py
# проверить:
.venv/Scripts/python test_cookie.py     # -> "УСПЕХ: получено результатов: N"

Claude Code에 연결

claude mcp add rutracker --scope user \
  --env HTTP_PROXY= --env HTTPS_PROXY= \
  -- /abs/path/.venv/Scripts/python.exe /abs/path/server.py --transport stdio

빈 HTTP_PROXY/HTTPS_PROXY — python이 가능한 시스템 프록시를 통해 접근하지 않도록 하기 위함입니다.

MCP 도구

서버는 .torrent 및 magnet 링크만 제공하며 콘텐츠 자체는 제공하지 않습니다. 다운로드에는 BitTorrent 클라이언트(qBittorrent, Transmission)를 사용하세요.

VPN 바인딩 설정

클라이언트는 이름에 zoog가 포함된 어댑터를 자동으로 찾습니다. 재정의하려면:

• RUTRACKER_VPN_ADAPTER — 어댑터 이름의 하위 문자열 (기본값 zoog);

• RUTRACKER_BIND_IP — 소켓 바인딩을 위한 명시적 IP.

둘 다 설정되지 않고 어댑터를 찾을 수 없으면 바인딩이 비활성화됩니다 (python은 일반 경로를 사용합니다).

보안

.env, cookies.json, .chrome-profile/에는 자격 증명/세션이 포함되어 있으며 git에서 제외됩니다 (.gitignore). 커밋하지 마세요.

감사의 말 / 라이선스

원본 MCP 서버 및 라이브러리는 CarrySauce, notnooblord입니다. 라이선스는 원본 프로젝트에서 상속됩니다.