About mcp-simple-arxiv
mcp-simple-arxiv is an MCP server that gives LLM clients access to arXiv papers through the arXiv API. It is aimed at researchers and users who need to find and read scientific literature. It can also convert full paper PDFs into Markdown.
Key features
- 01Search papers by title and abstract
- 02Filter results by submission date range
- 03Sort by submission date, update date or relevance
- 04Show total count of matching results
- 05Retrieve paper metadata and abstracts
- 06Retrieve full paper text as Markdown
Use cases
- 01Ask an LLM to find recent papers on a topic
- 02Survey research on a topic within a date range
- 03Read full paper text for summarization or questions
MCP support
The project is an MCP server that exposes arXiv search, metadata and full-text retrieval to LLM clients. It runs locally over stdio or as a network-accessible web server.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmcp-simple-arxiv
An MCP server that provides access to arXiv papers through their API.
Features
This server allows LLM clients (like Claude Desktop) to:
- Search for scientific papers on arXiv by title and abstract content
- Filter search results by submission date range
- Control search result sorting (by submission date, update date, or relevance)
- See total matching results count to gauge search specificity
- Get paper metadata and abstracts
- Retrieve full paper text as Markdown (converted from PDF)
- Access links to available paper formats (PDF/HTML)
- Browse and search arXiv subject categories
To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv . You can also install & use it locally.
Installation and Deployment
This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.
Installing via Smithery
To install Simple Arxiv for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-simple-arxiv --client claude
Manual Installation
pip install mcp-simple-arxiv
Usage with Claude Desktop
Add this configuration to your claude_desktop_config.json:
(Mac OS)
{
"mcpServers": {
"simple-arxiv": {
"command": "python",
"args": ["-m", "mcp_simple_arxiv"]
}
}
}
(Windows version):
{
"mcpServers": {
"simple-arxiv": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": [
"-m",
"mcp_simple_arxiv"
]
}
}
}
After restarting Claude Desktop, the following capabilities will be available:
Searching Papers
You can ask Claude to search for papers using queries like:
Can you search arXiv for recent papers about large language models?
The LLM can sort results by submission date, update date, or relevance:
Search arXiv for papers about transformers, sorted by relevance.
Date filtering lets you focus on specific time periods:
Find papers about quantum computing published in 2024.
Search for recent machine learning papers from the last 6 months.
Search results include:
- Total number of matching papers (e.g., "Found 15,234 total results, showing first 10")
- Paper title, authors, and arXiv ID
- Categories (primary and additional)
- Publication date
- Abstract preview
Getting Paper Details
Once you have a paper ID, you can ask for more details:
Can you show me the details for paper 2103.08220?
This will return:
- Full paper title
- Authors
- Publication and update dates
- Journal reference (if available)
- Paper abstract
- Links to available formats (PDF/HTML)
For web deployment see WEB_DEPLOYMENT.md.
Development
To install for development:
git clone https://github.com/andybrandt/mcp-simple-arxiv
cd mcp-simple-arxiv
pip install -e .
arXiv API Guidelines
This server follows arXiv API usage guidelines:
- Rate limiting to max 1 request per 3 seconds
- Single connection at a time
- Proper error handling and retry logic
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.