arXiv MCP Server
A Model Context Protocol server for searching and reading arXiv papers.
Features
- search - query arXiv with filters (date, category, sort)
- download - fetch paper PDF, convert to markdown
- read - access stored paper content
- list - view all downloaded papers
- prompts - deep paper analysis workflow
Prerequisites
- Python 3.11+
Installation
git clone <repo-url>
cd arxiv-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"arxiv": {
"command": "/path/to/.venv/bin/python",
"args": ["-m", "arxiv_mcp_server", "--storage-path", "/path/to/papers"]
}
}
}
Cursor
Add to MCP settings:
{
"mcpServers": {
"arxiv": {
"command": "python",
"args": ["-m", "arxiv_mcp_server"],
"env": {
"PYTHONPATH": "/path/to/arxiv-mcp-server/src"
}
}
}
}
Default storage: ~/.arxiv-mcp-server/papers
Tools
search_papers
{
"query": "transformer architecture",
"max_results": 10,
"date_from": "2023-01-01",
"categories": ["cs.AI", "cs.LG"],
"sort_by": "relevance"
}
download_paper
{
"paper_id": "2401.12345"
}
list_papers
{}
read_paper
{
"paper_id": "2401.12345"
}
Prompts
deep-paper-analysis
Comprehensive paper analysis workflow:
{
"paper_id": "2401.12345"
}
Covers: executive summary, methodology, results, implications, future directions.
Environment variables
| Variable | Default |
|---|---|
ARXIV_STORAGE_PATH | ~/.arxiv-mcp-server/papers |
License
MIT