Arxiv MCP Server

17 forks

146 stars

Free

What is arxiv-mcp-server

arxiv-mcp-server is a robust tool developed by the company blazickjp, designed to bridge the gap between AI assistants and the vast repository of research papers available on arXiv. By utilizing the Model Context Protocol (MCP), this server allows AI models to seamlessly search and access arXiv papers in a programmatic manner. This capability is particularly beneficial for researchers, students, and AI developers who need streamlined access to the latest academic research.

How to Use arxiv-mcp-server

Getting started with arxiv-mcp-server is straightforward. You can install it via Smithery or manually using a tool like uv. Once installed, integrate it into your MCP client by adding specific configurations that dictate how the server interacts with your local storage for papers. The server supports various tools and prompts that facilitate searching, downloading, and reading papers.

Installation Steps:

Via Smithery: Use the command line to automatically install it for Claude Desktop through the Smithery CLI.
Manual Installation: Utilize uv to install the server, create a virtual environment, and set up a development environment if necessary.

MCP Integration:

Configure your MCP client with the necessary command line arguments to run the server, specifying where downloaded papers should be stored.

Key Features of arxiv-mcp-server

The arxiv-mcp-server boasts several features that enhance its functionality and user experience:

Paper Search: Effortlessly search for papers using filters such as date range, category, and keywords. This feature helps users quickly locate relevant research.
Paper Access: Download and access the full content of papers directly from arXiv, enabling detailed analysis and review.
Paper Listing: Maintain a list of all downloaded papers, making it easy to organize and access your library of research documents.
Local Storage: Save papers locally to ensure faster access and offline availability.
Research Prompts: Utilize a set of predefined prompts that guide users through a comprehensive analysis of academic papers, covering aspects like methodology, results, and future research directions.

Tools Available:

Search Papers: Find papers based on specific criteria.
Download Paper: Retrieve a paper using its arXiv ID.
List Papers: View a list of all papers you have downloaded.
Read Paper: Access the content of any downloaded paper for in-depth study.

By providing these features, arxiv-mcp-server not only simplifies the process of accessing academic research but also enhances the ability of AI assistants to perform complex data retrieval and analysis tasks. It is an essential tool for anyone looking to integrate academic paper access into AI workflows.

Twitter Follow Python Version License: MIT PyPI Downloads PyPI Version

ArXiv MCP Server

🔍 Enable AI assistants to search and access arXiv papers through a simple MCP interface. The ArXiv MCP Server provides a bridge between AI assistants and arXiv's research repository through the Message Control Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way. 🤝 Contribute • 📝 Report Bug

✨ 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

To install ArXiv Server for Claude Desktop automatically via :

npx -y @/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 
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

The server provides four main tools:

1. Paper Search

Search for 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 its arXiv ID:

result = await call_tool("download_paper", {
 "paper_id": "2401.12345"

3. List Papers

View all downloaded papers:

result = await call_tool("list_papers", {})

4. Read Paper

Access the content of a downloaded paper:

result = await call_tool("read_paper", {
 "paper_id": "2401.12345"

📝 Research Prompts

The server offers specialized prompts to help analyze academic papers:

Paper Analysis Prompt

A comprehensive workflow for analyzing academic papers that only requires a paper ID:

result = await call_prompt("deep-paper-analysis", {
 "paper_id": "2401.12345"

This prompt includes:

Detailed instructions for using available tools (list_papers, download_paper, read_paper, search_papers)
A systematic workflow for paper analysis
Comprehensive analysis structure covering:
Executive summary
Research context
Methodology analysis
Results evaluation
Practical and theoretical implications
Future research directions
Broader impacts

⚙️ Configuration

🧪 Testing

Run the test suite:

python -m pytest

📄 License

Released under the MIT License. See the LICENSE file for details. Made with ❤️ by the Pearl Labs Team

How to Use

To use the arxiv-mcp-server, follow these steps:

Visit https://github.com/blazickjp/arxiv-mcp-serverhttps://github.com/blazic...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using arxiv-mcp-server capabilities within your Claude conversations

Additional Information

Created

November 29, 2024

Company

blazickjp

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More