arXiv MCP Server
Provides tools for searching and retrieving academic papers from arXiv, including searching by various criteria (title, author, abstract, category), retrieving paper details, and extracting full text content from PDFs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arXiv MCP Server search for recent papers about large language models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mnehmos.arxiv.mcp
An MCP (Model Context Protocol) server that provides tools for interacting with the arXiv API to search and retrieve academic papers.
Overview
This server implements the Model Context Protocol to provide tools for searching and retrieving papers from the arXiv preprint repository. It allows AI assistants to search for papers by various criteria, get details about specific papers, search by category, and extract full text content from PDFs.
Related MCP server: MCP Research Server (arXiv)
Features
Search Papers: Search for papers using various criteria (title, author, abstract, category, etc.)
Get Paper Details: Get detailed information about a specific paper by its arXiv ID
Category Search: Search for papers in a specific arXiv category
PDF Content Extraction: Download and extract full text content from paper PDFs
Structured Results: Returns properly parsed JSON data instead of raw XML
Caching: Intelligent PDF caching to avoid redundant downloads
Installation
Prerequisites
Node.js 18+
npm or pnpm
Setup
Clone this repository:
git clone https://github.com/Mnehmos/mnehmos.arxiv.mcp.git cd mnehmos.arxiv.mcpInstall dependencies:
npm installBuild the project:
npm run build
Usage
As an MCP Server
Start the server:
npm startThe server will run on stdio, allowing it to communicate with MCP clients.
MCP Client Configuration
Add this configuration to your MCP client settings. For Claude Desktop, add to your claude_desktop_config.json:
{
"mcpServers": {
"arxiv": {
"name": "arxiv-mcp-server",
"command": "node",
"args": ["build/index.js"],
"cwd": "C:/path/to/arxiv-mcp-server",
"enabled": true,
"alwaysAllow": [
"search_papers",
"get_paper",
"search_by_category",
"get_paper_content"
],
"env": {}
}
}
}For other MCP clients, use a similar configuration structure. Make sure to:
Update the
cwdpath to point to your arxiv-mcp-server directoryEnsure the
build/index.jsfile exists (runnpm run buildfirst)The
alwaysAllowarray lists tools that won't require user confirmation
Available Tools
search_papers
Search for papers on arXiv by various criteria with flexible query options.
Parameters:
query(string, optional): General search query across all fieldscategory(string, optional): arXiv category (e.g.,cs.AI,physics.optics)author(string, optional): Author name to search fortitle(string, optional): Words to search for in the titleabstract(string, optional): Words to search for in the abstractstart(number, optional): Starting index for pagination (0-based, default: 0)max_results(number, optional): Maximum number of results to return (max 2000, default: 10)sort_by(string, optional): Sort byrelevance,lastUpdatedDate, orsubmittedDatesort_order(string, optional): Sort orderascendingordescending
Example Response:
{
"feed_title": "arXiv Query: search_query=all:machine+learning",
"total_results": 150000,
"start_index": 0,
"items_per_page": 10,
"papers": [
{
"id": "http://arxiv.org/abs/2104.13478",
"arxiv_id": "2104.13478",
"title": "Advanced Machine Learning Techniques",
"summary": "This paper discusses advanced machine learning techniques...",
"authors": ["John Smith", "Jane Doe"],
"published": "2021-04-28T09:00:00Z",
"updated": "2021-04-28T09:00:00Z",
"categories": ["cs.LG", "cs.AI"],
"links": [
{
"href": "http://arxiv.org/abs/2104.13478",
"rel": "alternate",
"type": "text/html"
}
]
}
]
}get_paper
Get detailed information about a specific paper by its arXiv ID.
Parameters:
paper_id(string, required): arXiv paper ID (e.g.,2104.13478orcs/0001001)
Returns: Same structured format as search_papers but for a single paper.
search_by_category
Search for papers in a specific arXiv category with pagination and sorting options.
Parameters:
category(string, required): arXiv category (e.g.,cs.AI,physics.optics)start(number, optional): Starting index for pagination (0-based)max_results(number, optional): Maximum number of results to return (max 2000)sort_by(string, optional): Sort byrelevance,lastUpdatedDate, orsubmittedDatesort_order(string, optional): Sort orderascendingordescending
get_paper_content
Download and extract the full text content from a paper's PDF.
Parameters:
paper_id(string, required): arXiv paper ID (e.g.,2104.13478)
Features:
Downloads PDFs from arXiv's servers
Caches PDFs locally to avoid redundant downloads
Extracts and cleans text content using pdf-parse
Handles network errors and parsing issues gracefully
Returns plain text content suitable for analysis
Returns: Plain text content of the paper.
Common arXiv Categories
cs.AI- Artificial Intelligencecs.LG- Machine Learningcs.CL- Computation and Languagecs.CV- Computer Vision and Pattern Recognitionphysics.optics- Opticsmath.CO- Combinatoricsstat.ML- Machine Learning (Statistics)
For a complete list, see arXiv Subject Classifications.
Development
Running Tests
npm testBuild
npm run buildWatch Mode (for development)
npm run test:watchAPI Reference
This server uses the official arXiv API. For more information:
Contributing
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Changelog
v0.1.0 (Initial Release)
Basic arXiv API integration
Search papers by multiple criteria
Get individual paper details
Category-based search
PDF content extraction with caching
Structured JSON response parsing
MCP protocol implementation
Available Tools
4 toolsget_paperC
Get details about a specific paper by its arXiv ID
Inputs: paper_id (required).
get_paper_contentC
Get the full text content of a paper by downloading and extracting text from its PDF
Inputs: paper_id (required).
search_by_categoryC
Search for papers in a specific arXiv category
Inputs: category (required), start, max_results, sort_by, +1 more.
search_papersC
Search for papers on arXiv by various criteria
Inputs: query, category, author, title, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools are mostly distinct, with clear purposes: get_paper retrieves metadata, get_paper_content extracts text, search_by_category filters by category, and search_papers searches by general criteria. There is some potential overlap between search_by_category and search_papers, as category could be a criterion in search_papers, but the descriptions help differentiate them by emphasizing category-specific vs. general searches.
All tool names follow a consistent verb_noun pattern using snake_case: get_paper, get_paper_content, search_by_category, and search_papers. The naming is predictable and readable, with no deviations in style or convention across the set.
With 4 tools, the count is reasonable for an arXiv server, covering key operations like retrieving paper details, content, and searching. It is slightly under-scoped, as it lacks tools for updates, deletions, or advanced filtering, but it effectively supports core arXiv interactions without being overwhelming.
The tool set covers basic retrieval and search functions for arXiv papers, including metadata, content, and category-based searches. However, there are notable gaps: no tools for listing categories, handling paper versions, or managing user interactions (e.g., saving or citing papers), which limits comprehensive coverage of the arXiv domain.
Maintenance
Related MCP Connectors
Search arXiv, fetch paper metadata, and read full-text content.
Find academic papers across major sources like arXiv, PubMed, bioRxiv, and more. Download PDFs whe…
Find research papers and arXiv preprints, and get an abstract and free full text from a DOI or id.
Search and download academic papers from arXiv, PubMed, bioRxiv, medRxiv, Google Scholar, Semantic…
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables searching, retrieving, and parsing academic papers from arXiv, including keyword search, PDF downloads, content extraction from HTML/PDF formats, and accessing the latest AI research papers.48 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables searching and retrieving academic papers from arXiv by topic, allowing users to discover research papers and extract their metadata including titles, authors, abstracts, and PDF links through natural language queries.-
- AlicenseBqualityBmaintenanceEnables searching and retrieving academic papers from arXiv with support for advanced filtering by author, category, and date, plus full paper content extraction.1216MIT
- AlicenseBqualityDmaintenanceEnables searching academic papers on arXiv and retrieving detailed information such as title, authors, summary, and PDF link.16MIT