arXiv MCP Server

Instructions

Args:
    paper_id: arXiv paper ID (e.g., "2401.12345")
    section: Which section to return: "all", "abstract", "introduction", "method", "conclusion"

Returns:
    The paper text (full or specified section)

Implementation Reference

• src/arxiv_mcp_server/server.py:52-96 (handler)

  The main handler function for the 'get_paper' tool. It is decorated with @mcp.tool() for registration. Handles caching via storage, searching/downloading PDF if needed, text extraction, and section extraction.

  @mcp.tool()
  def get_paper(paper_id: str, section: str = "all") -> str:
      """Get the full text of an arXiv paper.
  
      Args:
          paper_id: arXiv paper ID (e.g., "2401.12345")
          section: Which section to return: "all", "abstract", "introduction", "method", "conclusion"
  
      Returns:
          The paper text (full or specified section)
      """
      # Check cache first
      cached_text = storage.get_text(paper_id)
      if cached_text:
          if section == "all":
              return cached_text
          return extract_section(cached_text, section)
  
      # Search for the paper
      papers = search_papers(paper_id, max_results=1)
      if not papers:
          return f"Paper {paper_id} not found."
  
      paper = papers[0]
  
      # Download PDF
      pdf_path = storage.get_pdf_path(paper_id)
      try:
          download_pdf(paper, str(pdf_path))
      except Exception as e:
          return f"Failed to download paper: {e}"
  
      # Extract text
      try:
          full_text = extract_text(str(pdf_path))
      except Exception as e:
          return f"Failed to extract text from PDF: {e}"
  
      # Cache results
      storage.save_paper_metadata(paper)
      storage.save_text(paper_id, full_text)
  
      if section == "all":
          return full_text
      return extract_section(full_text, section)

• src/arxiv_mcp_server/server.py:52-52 (registration)

  The @mcp.tool() decorator registers the get_paper function as an MCP tool.

  @mcp.tool()

• src/arxiv_mcp_server/server.py:54-62 (schema)

  The docstring provides the input schema (parameters) and output description for the tool.

  """Get the full text of an arXiv paper.
  
  Args:
      paper_id: arXiv paper ID (e.g., "2401.12345")
      section: Which section to return: "all", "abstract", "introduction", "method", "conclusion"
  
  Returns:
      The paper text (full or specified section)
  """

• src/arxiv_mcp_server/storage.py:49-53 (helper)

  Helper method used by get_paper for retrieving cached text.

  def get_text(self, paper_id: str) -> str | None:
      text_path = self.get_text_path(paper_id)
      if text_path.exists():
          return text_path.read_text()
      return None