Ray0907/arXiv-mcp
If you are the rightful owner of arXiv-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
A Model Context Protocol server that provides arXiv paper search and retrieval capabilities.
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) |
Use listCategories tool to get the full list.
Changelog
v0.2.0
Breaking Changes:
- Renamed entry point from
arxiv-server.pytoarxiv-mcpcommand - Renamed
gettool togetContentfor clarity
New Features:
searchAdvanced- Advanced search with title, abstract, date range filtersgetPaper- Get detailed paper metadata (authors, categories, dates, PDF URL)getRecent- Browse recent papers by categorylistCategories- List 33 common arXiv categories- Pagination support (
page,page_sizeparameters) - Sort options (
relevance,date_desc,date_asc) - Filter by author and category in basic search
Improvements:
- Migrated to
pyproject.tomlwith uv for dependency management - Replaced
requestswithhttpx(async-ready) - Added Pydantic models for type-safe data structures
- Reduced dependencies from 33 to 4 core packages
- Added proper timeout handling (30s)
- Modular project structure (
src/arxiv_mcp/)
v0.1.0
- Initial release
- Basic
searchandgettools
License
MIT License - see for details.
