qBittorrent MCP Server

Instructions

Implementation Reference

• main.py:154-192 (handler)

  The handler function for the 'get_torrent_info' MCP tool. It fetches torrent details from qBittorrent client (specific torrent or all), formats the data, and returns a list of torrent info dictionaries. Registered via the @mcp.tool() decorator.
  @mcp.tool() def get_torrent_info(torrent_hash: str = None) -> list[dict[str, Any]]: """ Get information about torrents in qBittorrent. Args: torrent_hash: Specific torrent hash to get info for (optional, returns all if not provided) Returns: List of torrent information """ client = get_qbt_client() if torrent_hash: torrents = client.torrents_info(torrent_hashes=torrent_hash) else: torrents = client.torrents_info() result = [] for torrent in torrents: result.append({ "hash": torrent.hash, "name": torrent.name, "size": torrent.size, "size_readable": f"{torrent.size / (1024**3):.2f} GB", "progress": f"{torrent.progress * 100:.2f}%", "state": torrent.state, "download_speed": f"{torrent.dlspeed / (1024**2):.2f} MB/s", "upload_speed": f"{torrent.upspeed / (1024**2):.2f} MB/s", "eta": torrent.eta, "seeders": torrent.num_seeds, "leechers": torrent.num_leechs, "ratio": torrent.ratio, "category": torrent.category, "tags": torrent.tags, "save_path": torrent.save_path }) return result
• main.py:17-38 (helper)

  Helper function to initialize and return the qBittorrent client instance, used by get_torrent_info and other tools.
  def get_qbt_client(): """Get or create qBittorrent client instance.""" global qbt_client if qbt_client is None: host = os.getenv("QBITTORRENT_HOST", "http://localhost:8080") username = os.getenv("QBITTORRENT_USERNAME", "admin") password = os.getenv("QBITTORRENT_PASSWORD", "adminadmin") qbt_client = qbittorrentapi.Client( host=host, username=username, password=password ) try: qbt_client.auth_log_in() except qbittorrentapi.LoginFailed as e: raise Exception(f"Failed to login to qBittorrent: {e}") return qbt_client