qBittorrent MCP Server

Instructions

Implementation Reference

• main.py:241-257 (handler)

  The main handler function for the 'resume_torrent' tool, decorated with @mcp.tool() to register it. It resumes the specified torrent using the qBittorrent client's torrents_resume method and returns a status dictionary.
  def resume_torrent(torrent_hash: str) -> dict[str, str]: """ Resume a paused torrent. Args: torrent_hash: Hash of the torrent to resume Returns: Status message """ client = get_qbt_client() try: client.torrents_resume(torrent_hashes=torrent_hash) return {"status": "success", "message": f"Torrent {torrent_hash} resumed"} except Exception as e: return {"status": "error", "message": str(e)}
• main.py:17-38 (helper)

  Helper function to get or initialize the qBittorrent client instance, used by the resume_torrent handler.
  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