rqbit Torrent Client MCP

Instructions

Implementation Reference

• rqbit_client/mcp_server.py:28-39 (handler)

  MCP tool handler for 'download_torrent'. Decorated with @mcp.tool() for registration. Handles input validation via type hints and docstring, logs the action, delegates to RqbitClient.add_torrent, and serializes the result to JSON or returns error.

  @mcp.tool()
  async def download_torrent(magnet_link_or_url_or_path: str) -> str:
      """Download a torrent from a magnet link, HTTP URL, or local file."""
      logger.info(
          f"Downloading torrent from magnet link/HTTP URL/local file: {magnet_link_or_url_or_path}"
      )
      result = await rqbit_client.add_torrent(magnet_link_or_url_or_path)
      if isinstance(result, str):
          error = f"Error downloading torrent {magnet_link_or_url_or_path}: {result}"
          logger.error(error)
          return error
      return dumps(result)

• rqbit_client/wrapper/client.py:139-156 (helper)

  Core helper method implementing torrent addition logic. Handles magnet links, HTTP URLs, and local files by posting to rqbit API endpoint /torrents with appropriate parameters and content handling.

  async def add_torrent(
      self, url_or_path: str, content: bytes | None = None
  ) -> dict[str, Any] | str:
      """Add a torrent from a magnet, HTTP URL, or local file."""
      url = "/torrents?&overwrite=true"
      if url_or_path.startswith("http"):
          url += "&is_url=true"
      if content:
          return await self._safe_request("POST", url, content=content)  # type: ignore
      if os.path.exists(url_or_path):
          try:
              with open(url_or_path, "rb") as f:
                  return await self._safe_request("POST", url, content=f.read())  # type: ignore
          except FileNotFoundError:
              return f"Error: File not found at {url_or_path}"
          except IOError as e:
              return f"Error reading file {url_or_path}: {e}"
      return await self._safe_request("POST", url, content=url_or_path)  # type: ignore