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

Popular Categories

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)