arxiv-mcp-search

# arXiv MCP Server MCP (Model Context Protocol) server for searching, downloading, and analyzing arXiv papers. Supports keyword search, Semantic Scholar-backed semantic search, PDF text extraction, and SQLite caching. ## Features - **Keyword Search** — full arXiv API query syntax (`ti:`, `au:`, `cat:`, `all:`) - **Semantic Search** — server-side semantic search via the Semantic Scholar API - **Hybrid Search** — arXiv keyword results enriched with Semantic Scholar citation counts - **PDF Download** — download and extract full text via PyMuPDF - **Smart Caching** — SQLite cache with configurable TTL (24h metadata, 30-day PDFs) - **Categories** — built-in taxonomy of ~150 arXiv categories - **Graceful Degradation** — semantic/hybrid fall back to keyword when Semantic Scholar is unavailable - **Lightweight** — no local ML model; depends only on `mcp` and `pymupdf` ## Install ```bash pip install arxiv-mcp-server ``` No model download — the server starts instantly. ## Claude Code Integration Add to `~/.claude/settings.json` or `.claude/settings.local.json`: ```json { "mcpServers": { "arxiv": { "command": "arxiv-mcp-server" } } } ``` Or from a virtual environment: ```json { "mcpServers": { "arxiv": { "command": "python", "args": ["-m", "arxiv_mcp_server.server"] } } } ``` ## Configuration All via environment variables: | Variable | Default | Description | |---|---|---| | `ARXIV_CACHE_DIR` | `~/.arxiv-mcp-server` | Cache root (DB + PDFs) | | `ARXIV_CACHE_TTL_HOURS` | `24` | Metadata cache lifetime | | `ARXIV_PDF_TTL_DAYS` | `30` | PDF retention period | | `ARXIV_RATE_LIMIT_SEC` | `1.0` | Min seconds between API calls | | `ARXIV_REQUEST_TIMEOUT` | `30` | API request timeout (seconds) | | `ARXIV_MAX_RESULTS` | `50` | Max results per search | | `ARXIV_LOG_LEVEL` | `INFO` | Python log level | ## Tools ### `search_papers` Search arXiv papers. ``` query: string (required) — search query max_results: int (default 10, max…