arXiv MCP Server

A Model Context Protocol server for searching and reading arXiv papers.

Features

• search - query arXiv with filters (date, category, sort)
• download - fetch paper PDF, convert to markdown
• read - access stored paper content
• list - view all downloaded papers
• prompts - deep paper analysis workflow

Prerequisites

• Python 3.11+

Installation

git clone <repo-url>
cd arxiv-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "arxiv": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "arxiv_mcp_server", "--storage-path", "/path/to/papers"]
    }
  }
}

Cursor

Add to MCP settings:

{
  "mcpServers": {
    "arxiv": {
      "command": "python",
      "args": ["-m", "arxiv_mcp_server"],
      "env": {
        "PYTHONPATH": "/path/to/arxiv-mcp-server/src"
      }
    }
  }
}

Default storage: ~/.arxiv-mcp-server/papers

Tools

search_papers

{
  "query": "transformer architecture",
  "max_results": 10,
  "date_from": "2023-01-01",
  "categories": ["cs.AI", "cs.LG"],
  "sort_by": "relevance"
}

download_paper

{
  "paper_id": "2401.12345"
}

list_papers

{}

read_paper

{
  "paper_id": "2401.12345"
}

Prompts

deep-paper-analysis

Comprehensive paper analysis workflow:

{
  "paper_id": "2401.12345"
}

Covers: executive summary, methodology, results, implications, future directions.

Environment variables

Variable	Default
ARXIV_STORAGE_PATH	~/.arxiv-mcp-server/papers

License

MIT