Skip to main content
Glama
ArXiv Sync MCP Server

ArXiv Sync MCP Server

by marfago

Python Version License: Apache 2.0

ArXiv Sync MCP Server

๐Ÿ” Enable AI assistants to search and access arXiv papers through a simple MCP interface.

๐Ÿ“Œ About This Fork

This is a fork of the original arxiv-mcp-server by Joseph Blazick.

Why This Fork?

This fork simplifies the architecture and fixes issues found in the original:

Feature

Original

This Fork

Download method

Async background conversion

Synchronous download & conversion

API calls

Multiple (download โ†’ poll status โ†’ read)

Single call returns content

Status tracking

Required

Not needed

PDF cleanup

Manual

Automatic after conversion

Date filtering

Buggy

Fixed

Complexity

Higher

Simpler

Key improvements:

  • The get_paper_content tool now downloads, converts PDF to markdown, and returns the content in a single call

  • Date filtering in search_papers now works correctly:

    • Uses direct HTTP requests to arXiv API to bypass encoding issues with the Python arxiv library

    • Properly formats date ranges in arXiv's submittedDate:[YYYYMMDD0000+TO+YYYYMMDD2359] format

    • Correctly combines date filters with category and query filters using AND operators

The ArXiv Sync MCP Server provides a bridge between AI assistants and arXiv's research repository through the Model Context Protocol (MCP). It allows AI models to search for papers and access their content programmatically.

Related MCP server: ArXiv MCP Server

โœจ 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

This fork is distributed via GitHub and is not published to PyPI.

Installing Manually

Install using uv:

uv tool install git+https://github.com/marfago/arxiv-sync-mcp-server.git

For development:

# Clone and set up development environment
git clone https://github.com/marfago/arxiv-sync-mcp-server.git
cd arxiv-sync-mcp-server

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install with test dependencies
uv pip install -e ".[test]"

๐Ÿ”Œ MCP Integration

Add this configuration to your MCP client config file:

{
    "mcpServers": {
        "arxiv-sync-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "--from",
                "git+https://github.com/marfago/arxiv-sync-mcp-server.git",
                "arxiv-sync-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

For Development:

{
    "mcpServers": {
        "arxiv-sync-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/cloned/arxiv-sync-mcp-server",
                "run",
                "arxiv-sync-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

๐Ÿ’ก Available Tools

The server provides three simple tools:

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. Get Paper Content

Get the full content of a paper, downloading and converting it if necessary:

result = await call_tool("get_paper_content", {
    "paper_id": "2401.12345"
})

3. List Papers

View all downloaded papers:

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

๐Ÿ“ 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 (get_paper_content, search_papers, list_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

Configure through environment variables:

Variable

Purpose

Default

ARXIV_STORAGE_PATH

Paper storage location

~/.arxiv-sync-mcp-server/papers

๐Ÿงช Testing

Run the test suite:

python -m pytest

๐Ÿ“„ License

Released under the Apache 2.0 License. See the LICENSE file for details.


Fork of arxiv-mcp-server by Joseph Blazick

Originally made with โค๏ธ

Available Tools

3 tools
get_paper_contentA

Get the full content of a paper, downloading and converting it if necessary

Inputs: paper_id (required).

list_papersA

List all existing papers available as resources

Inputs: no named parameters.

search_papersA

Search for papers on arXiv with advanced filtering and query optimization.

QUERY CONSTRUCTION GUIDELINES:

  • Use QUOTED PHRASES for exact matches: "multi-agent systems", "neural networks", "machine learning"

  • Combine related concepts with OR: "AI agents" OR "software agents" OR "intelligent agents"

  • Use field-specific searches for precision:

    • ti:"exact title phrase" - search in titles only

    • au:"author name" - search by author

    • abs:"keyword" - search in abstracts only

  • Use ANDNOT to exclude unwanted results: "machine learning" ANDNOT "survey"

  • For best results, use 2-4 core concepts rather than long keyword lists

ADVANCED SEARCH PATTERNS:

  • Field + phrase: ti:"transformer architecture" for papers with exact title phrase

  • Multiple fields: au:"Smith" AND ti:"quantum" for author Smith's quantum papers

  • Exclusions: "deep learning" ANDNOT ("survey" OR "review") to exclude survey papers

  • Broad + narrow: "artificial intelligence" AND (robotics OR "computer vision")

CATEGORY FILTERING (highly recommended for relevance):

  • cs.AI: Artificial Intelligence

  • cs.MA: Multi-Agent Systems

  • cs.LG: Machine Learning

  • cs.CL: Computation and Language (NLP)

  • cs.CV: Computer Vision

  • cs.RO: Robotics

  • cs.HC: Human-Computer Interaction

  • cs.CR: Cryptography and Security

  • cs.DB: Databases

EXAMPLES OF EFFECTIVE QUERIES:

  • ti:"reinforcement learning" with categories: ["cs.LG", "cs.AI"] - for RL papers by title

  • au:"Hinton" AND "deep learning" with categories: ["cs.LG"] - for Hinton's deep learning work

  • "multi-agent" ANDNOT "survey" with categories: ["cs.MA"] - exclude survey papers

  • abs:"transformer" AND ti:"attention" with categories: ["cs.CL"] - attention papers with transformer abstracts

DATE FILTERING: Use YYYY-MM-DD format for historical research:

  • date_to: "2015-12-31" - for foundational/classic work (pre-2016)

  • date_from: "2020-01-01" - for recent developments (post-2020)

  • Both together for specific time periods

RESULT QUALITY: Results sorted by RELEVANCE (most relevant papers first), not just newest papers. This ensures you get the most pertinent results regardless of publication date.

TIPS FOR FOUNDATIONAL RESEARCH:

  • Use date_to: "2010-12-31" to find classic papers on BDI, SOAR, ACT-R

  • Combine with field searches: ti:"BDI" AND abs:"belief desire intention"

  • Try author searches: au:"Rao" AND "BDI" for Anand Rao's foundational BDI work

Inputs: query (required), max_results, date_from, date_to, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: listing, searching, and getting full content. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent 'verb_noun' pattern in snake_case, making the set predictable and easy to understand.

    Tool Count5/5

    With 3 tools, the server is well-scoped for its purpose of syncing and retrieving arXiv papers. Each tool is necessary and sufficient.

    Completeness4/5

    The set covers listing, searching, and fetching content. Missing tools for updating or deleting are minor gaps given the sync context, but the core functionality is complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Provides paper search, PDF link retrieval, and content parsing for arXiv research papers, enabling seamless access to scientific literature through the Model Context Protocol.
      4
      38 npm
      24
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to search and access arXiv papers through a Model Context Protocol interface, allowing for paper search, download, listing, and reading functionality.
      4
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search, retrieve, analyze, and export academic papers from arXiv.org using the Model Context Protocol.
      19
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and retrieving arXiv papers via the Model Context Protocol, providing tools for querying, structured search, and literature review prompts.
      MIT