ArxivSearcher MCP Server

Instructions

Implementation Reference

• arxiv_searcher/arxiv_mcp.py:739-778 (handler)

  Synchronous handler function for the 'download_paper' MCP tool. Downloads arXiv paper PDF to a local directory using the arxiv library.

  @mcp.tool
  def download_paper(arxiv_id: str, directory: str = "downloaded_papers") -> dict:
      """
      Downloads the PDF of a paper to a local directory on the server.
      NOTE: In a stateless/free hosting environment, this file is temporary and
      will be deleted when the server restarts or sleeps.
  
      :param arxiv_id: The ArXiv ID of the paper to download (e.g., '2301.12345').
      :param directory: The local directory where the paper will be saved.
      """
      try:
          # Ensure the download directory exists
          os.makedirs(directory, exist_ok=True)
          
          search = arxiv.Search(id_list=[arxiv_id])
          paper = next(search.results())
          
          # Define a clean filename to avoid issues with special characters
          clean_id = re.sub(r'[^0-9v.]', '_', arxiv_id)
          filename = f"{clean_id}.pdf"
          
          # Download the paper to the specified directory
          paper.download_pdf(dirpath=directory, filename=filename)
          
          filepath = os.path.join(directory, filename)
          logging.info(f"Paper {arxiv_id} downloaded to {filepath}")
          
          return {
              "success": True,
              "arxiv_id": arxiv_id,
              "local_path": filepath,
              "message": f"Paper is temporarily available at the server path: {filepath}"
          }
          
      except StopIteration:
          logging.error(f"Paper with ID {arxiv_id} not found.")
          return {"success": False, "error": f"Paper with ID {arxiv_id} not found."}
      except Exception as e:
          logging.error(f"Failed to download paper {arxiv_id}: {e}")
          return {"success": False, "error": f"An unexpected error occurred: {str(e)}"}

• arxiv_searcher/remote_arxiv_mcp.py:738-777 (handler)

  Asynchronous handler function for the 'download_paper' MCP tool in the remote version. Downloads arXiv paper PDF to a local directory using the arxiv library.

  @mcp.tool
  async def download_paper(arxiv_id: str, directory: str = "downloaded_papers") -> dict:
      """
      Downloads the PDF of a paper to a local directory on the server.
      NOTE: In a stateless/free hosting environment, this file is temporary and
      will be deleted when the server restarts or sleeps.
  
      :param arxiv_id: The ArXiv ID of the paper to download (e.g., '2301.12345').
      :param directory: The local directory where the paper will be saved.
      """
      try:
          # Ensure the download directory exists
          os.makedirs(directory, exist_ok=True)
          
          search = arxiv.Search(id_list=[arxiv_id])
          paper = next(search.results())
          
          # Define a clean filename to avoid issues with special characters
          clean_id = re.sub(r'[^0-9v.]', '_', arxiv_id)
          filename = f"{clean_id}.pdf"
          
          # Download the paper to the specified directory
          paper.download_pdf(dirpath=directory, filename=filename)
          
          filepath = os.path.join(directory, filename)
          logging.info(f"Paper {arxiv_id} downloaded to {filepath}")
          
          return {
              "success": True,
              "arxiv_id": arxiv_id,
              "local_path": filepath,
              "message": f"Paper is temporarily available at the server path: {filepath}"
          }
          
      except StopIteration:
          logging.error(f"Paper with ID {arxiv_id} not found.")
          return {"success": False, "error": f"Paper with ID {arxiv_id} not found."}
      except Exception as e:
          logging.error(f"Failed to download paper {arxiv_id}: {e}")
          return {"success": False, "error": f"An unexpected error occurred: {str(e)}"}