blazickjp/arxiv-mcp-server

View on GitHub ↗

A Model Context Protocol server for searching and analyzing arXiv papers

3,063 ★248 forksPythonUpdated 1mo ago

What you need to know

MCP server for arXiv — search papers, download them, read bounded full text, retrieve original LaTeX by section, follow citation graphs, and maintain research alerts. Runs locally over stdio by default; papers and indexes stay on your machine.

Install

uvx arxiv-mcp-server (requires uv / uvx)
uv tool install arxiv-mcp-server (persistent PATH install)
Optional extras: 'arxiv-mcp-server[pdf]' (PDF conversion via pymupdf4llm) and 'arxiv-mcp-server[pro]' (local semantic search embeddings)
macOS Claude Desktop: bundled .mcpb from latest GitHub release (Apple Silicon / Intel), requires CPython 3.11.x

Usage

  • •claude mcp add --transport stdio --scope user arxiv -- uvx arxiv-mcp-server (or codex mcp add arxiv -- uvx arxiv-mcp-server)
  • •search_papers with query/categories/sort_by, then get_abstract by paper_id
  • •download_paper converts to local Markdown (HTML first, PDF fallback), then page through cached content with read_paper using next_start
  • •get_paper_latex -> list_paper_latex_sections -> get_paper_latex_section for section-level LaTeX reading
  • •Streamable HTTP: TRANSPORT=http HOST=127.0.0.1 PORT=8080 uvx arxiv-mcp-server

Key features

  • ✓14 tools: search_papers, get_abstract, download_paper, read_paper, get_paper_latex (+ sections), citation_graph (Semantic Scholar), export_citations (BibTeX), watch_topic/check_alerts, semantic_search/reindex ([pro])
  • ✓Bounded full-text reading with content_length/next_start pagination to avoid context overflow
  • ✓Section-level original LaTeX retrieval from validated, size-limited, cached source archives
  • ✓7 built-in MCP prompt workflows (research-discovery, deep-paper-analysis, literature-review, etc.)
  • ✓Streamable HTTP transport with DNS-rebinding protection and ALLOWED_HOSTS/ALLOWED_ORIGINS

Best for

Researchers and literature-review workflows where an agent must search, read, and cite arXiv papers with bounded context

Caveats

  • ⚠Do NOT install via npm/pnpm/npx — an unrelated npm package uses the same name; use uv/uvx
  • ⚠PDF fallback requires the [pdf] extra; semantic search requires [pro] and only operates on already-downloaded papers
  • ⚠Paper text and LaTeX are untrusted external content — papers can contain prompt-injection-style instructions; use client approval controls
  • ⚠Keep Streamable HTTP private unless authentication is provided upstream
Platforms: macOS · Windows · LinuxClients: Claude Code · OpenAI Codex / ChatGPT desktop · Kiro · VS Code · Claude Desktop · Any MCP client
Documentation ↗

Reviewed 2026-08-07

Topics

aiarxivclaude-aigptllmmcp-servermodel-context-protocolpaperspythonresearch
Stars
3,063★
Forks
248
Language
Python
License
Apache-2.0
Created
2024-11-29
Last push
2026-08-14