ArXiv MCP Server

1[![Twitter Follow](https://img.shields.io/twitter/follow/JoeBlazick?style=social)](https://twitter.com/JoeBlazick)
2[![smithery badge](https://smithery.ai/badge/arxiv-mcp-server)](https://smithery.ai/server/arxiv-mcp-server)
3[![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
4[![Tests](https://github.com/blazickjp/arxiv-mcp-server/actions/workflows/tests.yml/badge.svg)](https://github.com/blazickjp/arxiv-mcp-server/actions/workflows/tests.yml)
5[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6[![PyPI Downloads](https://img.shields.io/pypi/dm/arxiv-mcp-server.svg)](https://pypi.org/project/arxiv-mcp-server/)
7[![PyPI Version](https://img.shields.io/pypi/v/arxiv-mcp-server.svg)](https://pypi.org/project/arxiv-mcp-server/)
8 
9# ArXiv MCP Server
10 
11> 🔍 Enable AI assistants to search and access arXiv papers through a simple MCP interface.
12 
13The ArXiv MCP Server provides a bridge between AI assistants and arXiv's research repository through the Model Context Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way.
14 
15<div align="center">
16  
17🤝 **[Contribute](https://github.com/blazickjp/arxiv-mcp-server/blob/main/CONTRIBUTING.md)** • 
18📝 **[Report Bug](https://github.com/blazickjp/arxiv-mcp-server/issues)**
19 
20<a href="https://www.pulsemcp.com/servers/blazickjp-arxiv-mcp-server"><img src="https://www.pulsemcp.com/badge/top-pick/blazickjp-arxiv-mcp-server" width="400" alt="Pulse MCP Badge"></a>
21</div>
22 
23## ✨ Core Features
24 
25- 🔎 **Paper Search**: Query arXiv papers with filters for date ranges and categories
26- 📄 **Paper Access**: Download and read paper content
27- 📋 **Paper Listing**: View all downloaded papers
28- 🗃️ **Local Storage**: Papers are saved locally for faster access
29- 📝 **Prompts**: A Set of Research Prompts
30 
31## 🚀 Quick Start
32 
33### Installing via Smithery
34 
35To install ArXiv Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/arxiv-mcp-server):
36 
37```bash
38npx -y @smithery/cli install arxiv-mcp-server --client claude
39```
40 
41### Installing Manually
42Install using uv:
43 
44```bash
45uv tool install arxiv-mcp-server
46```
47 
48For development:
49 
50```bash
51# Clone and set up development environment
52git clone https://github.com/blazickjp/arxiv-mcp-server.git
53cd arxiv-mcp-server
54 
55# Create and activate virtual environment
56uv venv
57source .venv/bin/activate
58 
59# Install with test dependencies
60uv pip install -e ".[test]"
61```
62 
63### 🔌 MCP Integration
64 
65Add this configuration to your MCP client config file:
66 
67```json
68{
69    "mcpServers": {
70        "arxiv-mcp-server": {
71            "command": "uv",
72            "args": [
73                "tool",
74                "run",
75                "arxiv-mcp-server",
76                "--storage-path", "/path/to/paper/storage"
77            ]
78        }
79    }
80}
81```
82 
83For Development:
84 
85```json
86{
87    "mcpServers": {
88        "arxiv-mcp-server": {
89            "command": "uv",
90            "args": [
91                "--directory",
92                "path/to/cloned/arxiv-mcp-server",
93                "run",
94                "arxiv-mcp-server",
95                "--storage-path", "/path/to/paper/storage"
96            ]
97        }
98    }
99}
100```
101 
102## 💡 Available Tools
103 
104The server provides four main tools:
105 
106### 1. Paper Search
107Search for papers with optional filters:
108 
109```python
110result = await call_tool("search_papers", {
111    "query": "transformer architecture",
112    "max_results": 10,
113    "date_from": "2023-01-01",
114    "categories": ["cs.AI", "cs.LG"]
115})
116```
117 
118### 2. Paper Download
119Download a paper by its arXiv ID:
120 
121```python
122result = await call_tool("download_paper", {
123    "paper_id": "2401.12345"
124})
125```
126 
127### 3. List Papers
128View all downloaded papers:
129 
130```python
131result = await call_tool("list_papers", {})
132```
133 
134### 4. Read Paper
135Access the content of a downloaded paper:
136 
137```python
138result = await call_tool("read_paper", {
139    "paper_id": "2401.12345"
140})
141```
142 
143## 📝 Research Prompts
144 
145The server offers specialized prompts to help analyze academic papers:
146 
147### Paper Analysis Prompt
148A comprehensive workflow for analyzing academic papers that only requires a paper ID:
149 
150```python
151result = await call_prompt("deep-paper-analysis", {
152    "paper_id": "2401.12345"
153})
154```
155 
156This prompt includes:
157- Detailed instructions for using available tools (list_papers, download_paper, read_paper, search_papers)
158- A systematic workflow for paper analysis
159- Comprehensive analysis structure covering:
160  - Executive summary
161  - Research context
162  - Methodology analysis
163  - Results evaluation
164  - Practical and theoretical implications
165  - Future research directions
166  - Broader impacts
167 
168## ⚙️ Configuration
169 
170Configure through environment variables:
171 
172| Variable | Purpose | Default |
173|----------|---------|---------|
174| `ARXIV_STORAGE_PATH` | Paper storage location | ~/.arxiv-mcp-server/papers |
175 
176## 🧪 Testing
177 
178Run the test suite:
179 
180```bash
181python -m pytest
182```
183 
184## 📄 License
185 
186Released under the MIT License. See the LICENSE file for details.
187 
188---
189 
190<div align="center">
191 
192Made with ❤️ by the Pearl Labs Team
193 
194<a href="https://glama.ai/mcp/servers/04dtxi5i5n"><img width="380" height="200" src="https://glama.ai/mcp/servers/04dtxi5i5n/badge" alt="ArXiv Server MCP server" /></a>
195</div>
196