arxiv-mcp-server

Implements MCP tool interface to query arXiv's REST API with support for advanced search syntax (author, title, category filters, date ranges). Parses user natural language queries into arXiv API query strings, handles pagination, and returns structured metadata including abstracts, authors, publication dates, and PDF URLs. Uses HTTP client to communicate with arXiv's public API endpoint without authentication.

Parses arXiv API JSON responses and extracts key metadata fields (title, authors, abstract, publication date, categories, PDF URL, arXiv ID) into a consistent structured format. Formats results for readability in chat contexts, handling multi-author lists, category hierarchies, and URL encoding. Implements field mapping to normalize arXiv's native response schema into a developer-friendly output structure.

Registers arXiv search and retrieval functions as MCP tools with JSON Schema definitions that describe input parameters (query, filters, result limits) and output structure. Implements the MCP protocol's tool interface, allowing Claude, Cline, and other MCP clients to discover available tools, understand their parameters, and invoke them with proper type validation. Handles tool invocation routing and response serialization back to the MCP client.

Translates natural language search queries into arXiv's advanced search syntax, supporting filters for author names, paper titles, publication date ranges, and arXiv categories (cs.AI, physics.quant-ph, etc.). Implements parameter validation and escaping to prevent API errors, handles multi-value filters (e.g., multiple authors OR'd together), and constructs properly formatted query strings for the arXiv API. Supports both simple keyword search and complex boolean queries.

Implements pagination logic to handle arXiv API's result limits (typically 10-100 results per request), allowing users to retrieve large result sets across multiple API calls. Manages offset/limit parameters, accumulates results across batches, and provides mechanisms to control result count (e.g., 'get top 50 papers'). Handles empty result sets and API errors gracefully without losing previously fetched results.

Implements error handling for common arXiv API failures (rate limiting, timeouts, malformed queries, network errors) with appropriate HTTP status code interpretation and user-friendly error messages. Provides retry logic with exponential backoff for transient failures, validates input parameters before API calls to prevent unnecessary requests, and returns partial results when possible rather than failing completely. Logs errors for debugging while maintaining MCP protocol compliance.

Tracks previous search queries and results within an MCP session, using this history to inform subsequent searches and recommendations. Analyzes patterns in user searches (e.g., frequently searched authors, categories, keywords) and suggests related papers or refined queries. Implements lightweight session state management to maintain search context across multiple tool invocations without requiring external persistence.

Processes paper abstracts returned from arXiv searches and extracts key insights, research questions, and methodologies using pattern matching and NLP heuristics. Generates concise summaries suitable for quick scanning by researchers, highlighting novel contributions and relevance to search context. Integrates with Claude's native capabilities when available, delegating summarization to the LLM client rather than implementing custom NLP.