Arxiv MCP Server

What blazickjp/arxiv-mcp-server MCP server does

The blazickjp/arxiv-mcp-server MCP server supports an end-to-end workflow for working with arXiv literature. Agents can search by query, category, date, and sort order, then retrieve metadata and abstracts using an arXiv identifier. Downloaded papers are converted to local Markdown so later operations can inspect the stored content without repeatedly fetching the document.

The server also exposes the author-submitted LaTeX for downloaded papers in bounded sections. This is useful when the Markdown conversion does not provide enough detail or when an agent needs to inspect source structure. Citation tools retrieve references and citing papers, and can export BibTeX entries for one or more arXiv IDs.

How it works

The blazickjp/arxiv-mcp-server MCP server runs locally over stdio. Its default paper directory is ~/.arxiv-mcp-server/papers; a different absolute storage path can be supplied at launch. The basic working sequence is to identify a paper, download it, inspect its outline, and read only the relevant Markdown or LaTeX section. Tools for bounded passage search and paginated outlines help keep individual responses focused.

Searches, downloads, source retrieval, and citation graph requests call their relevant external services. Stored papers, semantic indexes, and topic watches are handled locally. Semantic search operates over downloaded papers, while reindex rebuilds the local semantic index when needed. Topic watches can be created, listed, checked for new papers, updated, or removed.

Setup and configuration

The documented installation uses the PyPI package through uvx:

uvx arxiv-mcp-server

The command requires uv, which provides uvx; no repository clone or separate Python environment is required. Clients that accept an mcpServers configuration can launch it with a stdio entry using uvx as the command and arxiv-mcp-server as its argument. Claude Desktop is given as an example of such a client, and a Cursor installation link is provided by the project.

To change where papers are stored, add --storage-path followed by an absolute directory path to the launch arguments. If a desktop application cannot locate uvx even though it works in a terminal, configure the client with the executable's absolute path. The published package is available as arxiv-mcp-server==0.7.2.

Tools and capabilities

The blazickjp/arxiv-mcp-server MCP server exposes tools for:

• Searching papers and retrieving abstracts and metadata.
• Downloading papers to local Markdown and listing or reading stored papers.
• Viewing Markdown outlines, sections, and bounded text matches.
• Retrieving bounded LaTeX, listing LaTeX sections, and reading individual source sections.
• Traversing citation relationships and exporting BibTeX.
• Saving topic watches, checking alerts, and removing watches.
• Searching downloaded papers by semantic similarity and rebuilding the local index.

These capabilities support literature discovery, focused paper review, source-level inspection, citation collection, and recurring topic monitoring.

Limitations and notes

This is a local server rather than a hosted endpoint, so the client machine must have uv available unless a supported desktop bundle is used. The Claude Desktop bundle described by the project is for macOS and requires CPython 3.11.x. The server depends on the relevant external arXiv services for online search, paper retrieval, and citation operations; local tools require the corresponding papers or indexes to already exist.

The project warns that an unrelated npm package has the same name. Installation should therefore use the PyPI package through uvx, not npm, pnpm, or npx. The repository is licensed under Apache-2.0.