ArXiv MCP Server

Executes structured queries against the arXiv API using the arxiv Python client library, supporting keyword search combined with category filters (cs.AI, physics.*, etc.) and date range constraints. The search_papers tool normalizes user queries into arXiv query syntax, handles pagination for large result sets, and returns metadata including title, authors, publication date, and abstract. Results are streamed back to the MCP client without requiring local storage, enabling real-time discovery workflows.

Downloads papers from arXiv as PDFs and converts them to Markdown format using the pymupdf4llm library, which extracts text, preserves structural hierarchy (headers, lists, tables), and maintains reading order. The download_paper tool retrieves the PDF via arXiv's direct download endpoint, processes it locally, and stores the Markdown output in a configurable local directory. Metadata (title, authors, abstract, arXiv ID) is embedded as YAML frontmatter in the Markdown file for downstream processing.

Maintains a local directory of downloaded papers with automatic metadata indexing. The list_papers tool scans the storage directory, parses YAML frontmatter from Markdown files, and returns a structured inventory including title, authors, publication date, arXiv ID, and file path. This enables quick discovery of previously downloaded papers without API calls and supports filtering/sorting operations on the local collection.

Retrieves the full Markdown content of previously downloaded papers from local storage via the read_paper tool. The tool accepts an arXiv ID or file path, loads the Markdown file, and returns the complete content including YAML frontmatter and converted paper text. This enables AI assistants to analyze paper content in subsequent prompts without re-downloading or re-converting, supporting multi-turn analysis workflows.

Provides a specialized MCP prompt (deep-paper-analysis) that guides AI assistants through a structured workflow for analyzing academic papers. The prompt defines a multi-step process: extracting key contributions, identifying methodology, analyzing results, and synthesizing implications. When invoked, the prompt system passes the paper content (typically loaded via read_paper) to the LLM with explicit instructions for structured analysis, enabling consistent interpretation across different papers and analysis sessions.

Implements a complete MCP (Model Context Protocol) server that registers and exposes paper management tools (search_papers, download_paper, list_papers, read_paper) and analysis prompts (deep-paper-analysis) to MCP-compatible clients. The server uses the mcp Python library to handle protocol compliance, manages stdio-based communication with clients, and routes tool calls to appropriate handlers. The server layer (src/arxiv_mcp_server/server.py) handles command parsing, response formatting, and error handling according to MCP specification.

Manages a configurable local directory for storing downloaded papers in Markdown format. The storage system is configured via environment variables or configuration files, with a default location that can be overridden. The download_paper tool writes converted papers to this directory with consistent naming (arXiv ID-based), and list_papers/read_paper tools read from the same directory. The architecture supports multiple storage backends through configuration, enabling flexibility in deployment scenarios.

Implements the MCP server using Python's asyncio framework for non-blocking I/O operations, enabling concurrent handling of multiple tool calls and client requests. The server architecture uses async/await patterns throughout the tool implementations (search_papers, download_paper, list_papers, read_paper), allowing long-running operations (PDF downloads, conversions) to proceed without blocking other client requests. This enables responsive multi-turn conversations where users can trigger multiple paper downloads or searches in parallel.

Provides a specialized MCP prompt (research-discovery) that guides AI assistants through discovering relevant research papers based on initial research questions or topics. The prompt defines a workflow for iterative search refinement: starting with broad searches, analyzing results, identifying gaps, and refining search queries. When invoked, the prompt system provides instructions for using the search_papers tool effectively, enabling systematic exploration of the arXiv repository without requiring users to manually craft complex search queries.