MCP Simple Arxiv

1# mcp-simple-arxiv
2 
3[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/andybrandt/mcp-simple-arxiv)](https://archestra.ai/mcp-catalog/andybrandt__mcp-simple-arxiv)
4[![smithery badge](https://smithery.ai/badge/mcp-simple-arxiv)](https://smithery.ai/server/mcp-simple-arxiv)
5[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/dc95dba9-149a-4eaa-bf08-36e0cb0f3a5a)
6 
7An MCP server that provides access to arXiv papers through their API.
8 
9<a href="https://glama.ai/mcp/servers/p38q3nagwb"><img width="380" height="200" src="https://glama.ai/mcp/servers/p38q3nagwb/badge" alt="mcp-simple-arxiv MCP server" /></a>
10 
11## Features
12 
13This server allows LLM clients (like Claude Desktop) to:
14- Search for scientific papers on arXiv by title and abstract content
15- Filter search results by submission date range
16- Control search result sorting (by submission date, update date, or relevance)
17- See total matching results count to gauge search specificity
18- Get paper metadata and abstracts
19- Retrieve full paper text as Markdown (converted from PDF)
20- Access links to available paper formats (PDF/HTML)
21- Browse and search arXiv subject categories
22 
23To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv .
24You can also install & use it locally. 
25 
26## Installation and Deployment
27 
28This server can be run in two modes: as a local `stdio` server for desktop clients or as a network-accessible web server.
29 
30### Installing via Smithery
31 
32To install Simple Arxiv for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-simple-arxiv):
33 
34```bash
35npx -y @smithery/cli install mcp-simple-arxiv --client claude
36```
37 
38### Manual Installation
39```bash
40pip install mcp-simple-arxiv
41```
42 
43## Usage with Claude Desktop
44 
45Add this configuration to your `claude_desktop_config.json`:
46 
47(Mac OS)
48 
49```json
50{
51  "mcpServers": {
52    "simple-arxiv": {
53      "command": "python",
54      "args": ["-m", "mcp_simple_arxiv"]
55      }
56  }
57}
58```
59 
60(Windows version):
61 
62```json
63{
64  "mcpServers": {
65    "simple-arxiv": {
66      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
67      "args": [
68        "-m",
69        "mcp_simple_arxiv"
70      ]
71    }
72  }
73}
74```
75 
76After restarting Claude Desktop, the following capabilities will be available:
77 
78### Searching Papers
79 
80You can ask Claude to search for papers using queries like:
81```
82Can you search arXiv for recent papers about large language models?
83```
84 
85The LLM can sort results by submission date, update date, or relevance:
86```
87Search arXiv for papers about transformers, sorted by relevance.
88```
89 
90Date filtering lets you focus on specific time periods:
91```
92Find papers about quantum computing published in 2024.
93Search for recent machine learning papers from the last 6 months.
94```
95 
96Search results include:
97- Total number of matching papers (e.g., "Found 15,234 total results, showing first 10")
98- Paper title, authors, and arXiv ID
99- Categories (primary and additional)
100- Publication date
101- Abstract preview
102 
103### Getting Paper Details
104 
105Once you have a paper ID, you can ask for more details:
106```
107Can you show me the details for paper 2103.08220?
108```
109 
110This will return:
111- Full paper title
112- Authors
113- Publication and update dates
114- Journal reference (if available)
115- Paper abstract
116- Links to available formats (PDF/HTML)
117 
118 
119*For web deployment see [WEB_DEPLOYMENT.md](WEB_DEPLOYMENT.md)*.
120 
121## Development
122 
123To install for development:
124```bash
125git clone https://github.com/andybrandt/mcp-simple-arxiv
126cd mcp-simple-arxiv
127pip install -e .
128```
129 
130### arXiv API Guidelines
131 
132This server follows arXiv API usage guidelines:
133- Rate limiting to max 1 request per 3 seconds
134- Single connection at a time
135- Proper error handling and retry logic
136 
137## License
138 
139MIT
140