An MCP server that provides access to arXiv papers through their API.
Project description
mcp-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
- Get paper metadata and abstracts
- Access links to available paper formats (PDF/HTML)
The server implements proper rate limiting according to arXiv's API guidelines (max 1 request every 3 seconds).
Installation
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 search will return basic information about matching papers including:
- Paper title
- Authors
- arXiv ID
- Publication date
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)
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_simple_arxiv-0.3.0.tar.gz.
File metadata
- Download URL: mcp_simple_arxiv-0.3.0.tar.gz
- Upload date:
- Size: 11.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1750aa9c6df1581932a4e0a9575e0b2ecbda8413b8f7a0fc7974fe0acee241c
|
|
| MD5 |
9df6d7671e61231dea04958f07d5c7b7
|
|
| BLAKE2b-256 |
f1d5a532332bb9abcc41bf94c98b647ae6e1d15443ba9af53e941b77c155dbbe
|
File details
Details for the file mcp_simple_arxiv-0.3.0-py3-none-any.whl.
File metadata
- Download URL: mcp_simple_arxiv-0.3.0-py3-none-any.whl
- Upload date:
- Size: 13.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e29718b4c2f93e403164db2781f64a54585172703b1ddd3a61ee679200c1f52
|
|
| MD5 |
defc823cf3727eaaf57d84984b49ce8e
|
|
| BLAKE2b-256 |
7e0735ed76ed133abd4664a05c3e840fc6352b4c8045e3c59936961cad565625
|