MCP 服务器

arXiv MCP Server

Enables searching and retrieving academic papers from arXiv with support for advanced filtering by author, category, and date, plus full paper content extraction.

README

arXiv MCP Server

A Model Context Protocol (MCP) server that provides arXiv paper search and retrieval capabilities. This server enables LLMs to search for academic papers on arXiv and get cleaned titles, abstracts, authors, and content without dealing with complex HTML parsing.

Features

Search papers by query, author, category, and date
Advanced search with specific field filters
Get detailed paper metadata (title, abstract, authors, categories)
Retrieve full paper content via Jina Reader
Browse recent papers by category
List all arXiv categories
Pagination support for search results

Available Tools

`search`

Search arXiv for papers matching a query.

Argument	Type	Required	Description
`query`	string	Yes	Search query (e.g., 'LLM', 'transformer')
`category`	string	No	Filter by category (e.g., 'cs.AI', 'cs.LG')
`author`	string	No	Filter by author name
`sort_by`	string	No	Sort order: 'relevance', 'date_desc', 'date_asc'
`page`	int	No	Page number (default: 1)
`page_size`	int	No	Results per page, max 50 (default: 25)

`searchAdvanced`

Advanced search with specific field filters.

Argument	Type	Required	Description
`title`	string	No	Search in paper titles
`abstract`	string	No	Search in abstracts
`author`	string	No	Search by author name
`category`	string	No	Filter by category
`id_arxiv`	string	No	Search by arXiv ID pattern
`date_from`	string	No	Start date (YYYY-MM-DD)
`date_to`	string	No	End date (YYYY-MM-DD)
`sort_by`	string	No	Sort order
`page`	int	No	Page number
`page_size`	int	No	Results per page

`getPaper`

Get detailed information about a specific arXiv paper.

Argument	Type	Required	Description
`id_or_url`	string	Yes	arXiv ID (e.g., '2301.00001') or full URL

`getContent`

Get the full text content of an arXiv paper using Jina Reader.

Argument	Type	Required	Description
`id_or_url`	string	Yes	arXiv ID or full URL

`getRecent`

Get recent papers from a specific arXiv category.

Argument	Type	Required	Description
`category`	string	No	Category code (default: 'cs.AI')
`count`	int	No	Number of papers, max 50 (default: 10)

`listCategories`

List all common arXiv categories with their codes and names.

Installation

Using uv (Recommended)

# Clone the repository
git clone https://github.com/Ray0907/arXiv-mcp.git
cd arXiv-mcp

# Install with uv
uv sync

Using pip

# Clone the repository
git clone https://github.com/Ray0907/arXiv-mcp.git
cd arXiv-mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install
pip install -e .

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "arxiv": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/arXiv-mcp",
        "run",
        "arxiv-mcp"
      ]
    }
  }
}

Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "arxiv": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/arXiv-mcp",
        "run",
        "arxiv-mcp"
      ]
    }
  }
}

Usage Examples

Search for papers about LLMs

Search for recent papers about "large language models"

Find papers by a specific author

Search for papers by "Yann LeCun" in the machine learning category

Get paper details

Get the details of arXiv paper 2301.00001

Browse recent papers

Show me the 10 most recent papers in cs.AI

Development

Run tests

uv run pytest

Run the server locally

uv run arxiv-mcp

Common arXiv Categories

Code	Name
cs.AI	Artificial Intelligence
cs.CL	Computation and Language
cs.CV	Computer Vision and Pattern Recognition
cs.LG	Machine Learning
cs.NE	Neural and Evolutionary Computing
stat.ML	Machine Learning (Statistics)