MCP HubMCP Hub
blazickjp

arxiv-mcp-server

by: blazickjp

A Model Context Protocol server for searching and analyzing arXiv papers

895created 29/11/2024
Visit
arXiv
analysis

📌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:

VariablePurposeDefault
ARXIV_STORAGE_PATHPaper 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