ArXiv Search

Simple CLI tool and MCP server for searching arXiv papers via ArXiv Xplorer API.

Installation

# Using pip
pip install -e .

# Using uv
uv pip install -e .

# Or from GitHub
pip install git+https://github.com/hassenhamdi/arxiv-xplorer-mcp.git

CLI Usage

# Basic search
arxiv-search "large language models"

# With categories
arxiv-search "transformer" -c cs.CL cs.AI

# With years
arxiv-search "neural networks" -y 2023 2024

# Pagination
arxiv-search "attention" -p 2

# JSON output
arxiv-search "BERT" --json

Options

Option	Description
query	Search terms (required)
-c, --categories	arXiv categories (e.g., cs.CL, cs.AI)
-y, --years	Publication years (e.g., 2023 2024)
-p, --page	Page number (default: 1)
--json	Output raw JSON

Popular Categories

Code	Description
cs.CL	Computation and Language (NLP)
cs.AI	Artificial Intelligence
cs.CV	Computer Vision
cs.LG	Machine Learning
cs.RO	Robotics
cs.CR	Cryptography and Security

MCP Server

Configuration

Claude Desktop / Cline / OpenCode:

{
  "mcpServers": {
    "arxiv": {
      "command": "python",
      "args": ["-m", "arxiv_search.mcp_server"],
      "cwd": "/path/to/arxiv_search"
    }
  }
}

Tool: arxiv_search

Search arXiv papers with filters.

Parameters:

• query (string, required): Search terms
• categories (list, optional): arXiv categories
• years (list, optional): Publication years
• page (integer, optional): Page number (default: 1)

Returns: List of papers with fields: id, title, abstract, authors, date, categories, short_author, score, url

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run CLI
python arxiv.py "query"

# Run MCP server
python -m arxiv_search.mcp_server

License

Personal Use Only - See LICENSE file

Disclaimer

Uses reverse-engineered API from arxivxplorer.com (unofficial)