arxiv-mcp-server
by: blazickjp
A Model Context Protocol server for searching and analyzing arXiv papers
📌Overview
Purpose: To provide a seamless interface for AI assistants to search and access research papers on arXiv using the Message Control Protocol (MCP).
Overview: The ArXiv MCP Server acts as a bridge connecting AI models with arXiv's extensive database of research papers, enabling users to programmatically search for, access, and manage academic content efficiently.
Key Features:
-
Paper Search: Allows users to query arXiv for papers with advanced filters like date ranges and categories, enhancing the searching experience.
-
Paper Access: Provides the capability to download and read papers directly, simplifying the retrieval of academic content.
-
Paper Listing: Facilitates tracking of all downloaded papers for easy reference and organization.
-
Local Storage: Ensures papers are saved locally, leading to faster access during repeated inquiries.
-
Prompts for Research: Offers a comprehensive set of research prompts designed to assist in analyzing academic papers effectively.
ArXiv MCP Server
Enable AI assistants to search and access arXiv papers through a simple MCP interface.
The ArXiv MCP Server bridges AI assistants and arXiv's research repository via the Model Context Protocol (MCP). It enables AI models to search and access paper content programmatically.
Core Features
- Paper Search: Query arXiv papers with filters for date ranges and categories
- Paper Access: Download and read paper content
- Paper Listing: View all downloaded papers
- Local Storage: Papers are saved locally for faster access
- Prompts: A set of research prompts
Quick Start
Installing via Smithery
To install ArXiv Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install arxiv-mcp-server --client claude
Installing Manually
Install using uv:
uv tool install arxiv-mcp-server
For development:
# Clone and set up development environment
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install with test dependencies
uv pip install -e ".[test]"
MCP Integration
Add this configuration to your MCP client config file:
{
"mcpServers": {
"arxiv-mcp-server": {
"command": "uv",
"args": [
"tool",
"run",
"arxiv-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}
For development:
{
"mcpServers": {
"arxiv-mcp-server": {
"command": "uv",
"args": [
"--directory",
"path/to/cloned/arxiv-mcp-server",
"run",
"arxiv-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}
Available Tools
1. Paper Search
Search papers with optional filters:
result = await call_tool("search_papers", {
"query": "transformer architecture",
"max_results": 10,
"date_from": "2023-01-01",
"categories": ["cs.AI", "cs.LG"]
})
2. Paper Download
Download a paper by arXiv ID:
result = await call_tool("download_paper", {
"paper_id": "2401.12345"
})
3. List Papers
List all downloaded papers:
result = await call_tool("list_papers", {})
4. Read Paper
Access content of a downloaded paper:
result = await call_tool("read_paper", {
"paper_id": "2401.12345"
})
Research Prompts
Specialized prompts to assist academic paper analysis.
Paper Analysis Prompt
Comprehensive workflow using only a paper ID:
result = await call_prompt("deep-paper-analysis", {
"paper_id": "2401.12345"
})
Includes:
- Instructions for tools: list_papers, download_paper, read_paper, search_papers
- Systematic analysis workflow
- Coverage of:
- Executive summary
- Research context
- Methodology analysis
- Results evaluation
- Practical and theoretical implications
- Future research directions
- Broader impacts
Configuration
Set via environment variables:
Variable | Purpose | Default |
---|---|---|
ARXIV_STORAGE_PATH | Paper storage location | ~/.arxiv-mcp-server/papers |
Testing
Run tests with:
python -m pytest
License
Released under the MIT License. See the LICENSE file for details.
Made with ❤️ by the Pearl Labs Team