arXiv MCP Server

Instructions

Implementation Reference

• src/arxiv_server/server.py:345-413 (handler)

  The handler function for the 'search_arxiv' tool. It constructs a search query from provided parameters (all_fields, title, author, abstract), calls the arXiv API, parses the feed, and returns a dictionary mapping article titles to their arXiv IDs and authors. Registered via @mcp.tool() decorator.
  @mcp.tool() async def search_arxiv( ctx: Context, all_fields: Optional[str] = None, title: Optional[str] = None, author: Optional[str] = None, abstract: Optional[str] = None, start: int = 0, max_results: int = 10, ) -> Any: """ Performs a search query on the arXiv API based on specified parameters and returns matching article metadata. This function allows for flexible querying of the arXiv database. Only parameters that are explicitly provided will be included in the final search query. Results are returned in a JSON-formatted string with article titles as keys and their corresponding arXiv IDs as values. Args: all_fields: General keyword search across all metadata fields including title, abstract, authors, comments, and categories. title: Keyword(s) to search for within the titles of articles. author: Author name(s) to filter results by. abstract: Keyword(s) to search for within article abstracts. start: Index of the first result to return; used for paginating through search results. Defaults to 0. max_results: Maximum number of results to return (1-50). Returns: A JSON-formatted string containing article titles and their associated arXiv IDs; otherwise, a structured error JSON string. """ prefixed_params = [] if author: author = format_text(author) prefixed_params.append(f"au:{author}") if all_fields: all_fields = format_text(all_fields) prefixed_params.append(f"all:{all_fields}") if title: title = format_text(title) prefixed_params.append(f"ti:{title}") if abstract: abstract = format_text(abstract) prefixed_params.append(f"abs:{abstract}") # Construct search query search_query = " AND ".join(prefixed_params) params = { "search_query": search_query, "start": start, "max_results": max(1, min(max_results, 50)), } await ctx.info("Calling the API") response = await make_api_call(f"{ARXIV_API_BASE}/query", params=params) if response is None: return _error("API_ERROR", "Unable to retrieve data from arXiv.org.") feed = feedparser.parse(response) error_msg = ( "Unable to extract information for your query. " "This issue may stem from an incorrect search query." ) if not feed.entries: return _error("NOT_FOUND", error_msg) entries: Dict[str, Dict[str, Any]] = {} await ctx.info("Extracting information") for entry in feed.entries: id = entry.id article_title = entry.title arxiv_id = id.split("/abs/")[-1] authors = [author['name'] for author in entry.authors] entries[article_title] = {"arXiv ID": arxiv_id, "Authors": authors} return entries