Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Rtorrent

БесплатноНе проверен

MCP server for rTorrent BitTorrent automation, enabling torrent management (add/list/pause/delete), multi-source searching (Nyaa, Pirate Bay, etc.), and post-pr

GitHubEmbed

Описание

MCP server for rTorrent BitTorrent automation, enabling torrent management (add/list/pause/delete), multi-source searching (Nyaa, Pirate Bay, etc.), and post-processing workflows via natural language.

README

Just Ruff Python FastMCP

⛔ Not for piracy.

This software does not help with copyright infringement — no infringing sources, no sourcing help, no configuration for infringing purposes. BitTorrent is neutral infrastructure with real lawful uses; this repo is for those. Read first: Legal notice · Lawful sourcing · Safety · Country specifics. Sourcing questions in issues are respectfully declined and closed.

Talk to Claude to add torrents, search anime/manga/movies/ebooks across half a dozen sites, and get finished downloads renamed and sorted into Plex or Jellyfin automatically.

What this wraps

rtorrent-mcp drives a torrent client over its automation interface — it does not scrape a generic download site. Two backends, one tool surface (TORRENT_BACKEND, default rtorrent):

  • rTorrent over XML-RPC/SCGI (not bundled; easiest via the included Docker Compose stack — see Quick Install below).
  • qBittorrent over its WebUI API v2 (native exe, no Docker needed). Set TORRENT_BACKEND=qbittorrent plus QBITTORRENT_URL (and QBITTORRENT_API_KEY on ≥ v5.2.0, else username/password).

Full rTorrent setup, plugins, and troubleshooting: docs/RTORRENT_SETUP.md. Backend design, client coverage, and no-seed proof gates: docs/DUAL_BACKEND_SPEC.md.

What You Can Do

How it runs: talks to your torrent backend (rTorrent over XML-RPC, Docker recommended; or native qBittorrent over its WebUI API) plus a small companion web dashboard (web_sota/) as a lightweight alternative to the full ruTorrent WebUI bundled in the same Docker image.

Direction Artifacts Notes
Hands-in Magnet links, search queries, natural-language commands Via MCP tools or the webapp
Hands-out Added/managed torrents, search results, renamed & sorted media files Plex/Jellyfin libraries notified automatically
  • Search anime (nyaa.si), manga, Japanese TV, movies (YTS), TV shows, ebooks (Anna's Archive, Project Gutenberg), and comics from one place
  • Add, pause, resume, and delete torrents; check status and health
  • Automatic post-processing: rename, move, and notify Plex/Jellyfin when a download completes
  • Natural-language commands in English or German ("get me this week's asw anime, 720p")
  • Franchise and batch-series download workflows
  • Austrian legal-context hints on search results (not legal advice)

Quick Install

  1. Get rTorrent running: docker compose up -d (see Onboarding)
  2. Download the latest .mcpb from Releases and drag it onto Claude Desktop

That's it — no Python, git, or terminal required. Other install methods (mcpb CLI, manual config, dev mode with just): INSTALL.md.

Example Prompts

  • "Get me this week's ASW anime in 720p"
  • "Search for The Matrix on YTS in 1080p"
  • "Check for completed downloads and notify Plex"

Documentation

Doc Contents
Installation All install methods, prerequisites, troubleshooting
Onboarding First-time rTorrent + Anna's Archive setup
Architecture Ports, tool surface, media pipeline, key files
Configuration All environment variables and config options
Tool Reference Every MCP tool and action, with examples
Development Dev setup, tests, code style, contributing
Troubleshooting Common issues and fixes
Extended Search Guide Full guide to manga, movies, ebooks, comics, metadata search
*arr Integration Wiring rTorrent as a Radarr/Sonarr download client
Product Requirements Background and product rationale
Legal notice Not-for-piracy stance, what this software is, issue policy
Lawful sourcing What you may lawfully put through a client
Torrenting safety Swarm visibility, VPN limits, malware, seeding liability
Country specifics Austria, Germany, USA, UK, Japan enforcement (+ EMEA: FR/IT/NL/CH/ES)
VPN privacy Justified uses, dual use, criteria, named providers, what fails

Austrian context

This tool is built around the Austrian legal context, where personal downloading is generally tolerated, and includes AT-oriented risk hints on search results. Full picture (beyond Austria): Country specifics. Users in other jurisdictions should research local copyright law — high-risk countries (e.g. Germany, Japan) warrant extra caution. This is not legal advice.

Requirements

  • Python 3.13+ and uv
  • Docker Desktop (recommended, for running rTorrent)
  • Claude Desktop, or any MCP-compatible client

License

MIT — see LICENSE.

Acknowledgments

  • rTorrent — the lightweight torrent client
  • Nyaa.si — anime torrent indexer
  • FastMCP — the MCP server framework

from github.com/sandraschi/rtorrent-mcp

Установка Rtorrent

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/rtorrent-mcp

FAQ

Rtorrent MCP бесплатный?

Да, Rtorrent MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Rtorrent?

Нет, Rtorrent работает без API-ключей и переменных окружения.

Rtorrent — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Rtorrent в Claude Desktop, Claude Code или Cursor?

Открой Rtorrent на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Rtorrent with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development