rutracker_mcp

MCP-сервер для RuTracker — поиск раздач и скачивание .torrent-файлов прямо из Claude (Desktop / Code / API) и любых MCP-совместимых клиентов.

⚠️ Это форк. Основан на CarrySauce/rutracker-mcp-server (который, в свою очередь, форк notnooblord/rutracker-mcp-server), на FastMCP + py-rutracker-client. Оригинальный MCP-сервер (server.py) и набор инструментов сохранены без изменений. Форк добавляет обход блокировок для доступа из РФ.

Зачем форк

Оригинал логинится обычным POST на login.php. В российских условиях это не работает:

1. Cloudflare Managed Challenge. RuTracker закрыт анти-бот-проверкой Cloudflare; простой HTTP-клиент (aiohttp) её не проходит и получает 403.

2. Блокировка РКН + привязка cf_clearance к IP. Сайт заблокирован у российских провайдеров, а токен 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

• VPN с TAP-адаптером (протестировано на ZoogVPN). Из РФ — обязательно.

• Google Chrome (для добычи cookie через 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. Лицензия наследуется от оригинального проекта.