Skip to main content
Glama
arXiv MCP Server

arXiv MCP Server

by Mnehmos

mnehmos.arxiv.mcp

An MCP (Model Context Protocol) server that provides tools for interacting with the arXiv API to search and retrieve academic papers.

Overview

This server implements the Model Context Protocol to provide tools for searching and retrieving papers from the arXiv preprint repository. It allows AI assistants to search for papers by various criteria, get details about specific papers, search by category, and extract full text content from PDFs.

Related MCP server: MCP Research Server (arXiv)

Features

  • Search Papers: Search for papers using various criteria (title, author, abstract, category, etc.)

  • Get Paper Details: Get detailed information about a specific paper by its arXiv ID

  • Category Search: Search for papers in a specific arXiv category

  • PDF Content Extraction: Download and extract full text content from paper PDFs

  • Structured Results: Returns properly parsed JSON data instead of raw XML

  • Caching: Intelligent PDF caching to avoid redundant downloads

Installation

Prerequisites

  • Node.js 18+

  • npm or pnpm

Setup

  1. Clone this repository:

    git clone https://github.com/Mnehmos/mnehmos.arxiv.mcp.git
    cd mnehmos.arxiv.mcp
  2. Install dependencies:

    npm install
  3. Build the project:

    npm run build

Usage

As an MCP Server

Start the server:

npm start

The server will run on stdio, allowing it to communicate with MCP clients.

MCP Client Configuration

Add this configuration to your MCP client settings. For Claude Desktop, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "arxiv": {
      "name": "arxiv-mcp-server",
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "C:/path/to/arxiv-mcp-server",
      "enabled": true,
      "alwaysAllow": [
        "search_papers",
        "get_paper",
        "search_by_category",
        "get_paper_content"
      ],
      "env": {}
    }
  }
}

For other MCP clients, use a similar configuration structure. Make sure to:

  • Update the cwd path to point to your arxiv-mcp-server directory

  • Ensure the build/index.js file exists (run npm run build first)

  • The alwaysAllow array lists tools that won't require user confirmation

Available Tools

search_papers

Search for papers on arXiv by various criteria with flexible query options.

Parameters:

  • query (string, optional): General search query across all fields

  • category (string, optional): arXiv category (e.g., cs.AI, physics.optics)

  • author (string, optional): Author name to search for

  • title (string, optional): Words to search for in the title

  • abstract (string, optional): Words to search for in the abstract

  • start (number, optional): Starting index for pagination (0-based, default: 0)

  • max_results (number, optional): Maximum number of results to return (max 2000, default: 10)

  • sort_by (string, optional): Sort by relevance, lastUpdatedDate, or submittedDate

  • sort_order (string, optional): Sort order ascending or descending

Example Response:

{
  "feed_title": "arXiv Query: search_query=all:machine+learning",
  "total_results": 150000,
  "start_index": 0,
  "items_per_page": 10,
  "papers": [
    {
      "id": "http://arxiv.org/abs/2104.13478",
      "arxiv_id": "2104.13478",
      "title": "Advanced Machine Learning Techniques",
      "summary": "This paper discusses advanced machine learning techniques...",
      "authors": ["John Smith", "Jane Doe"],
      "published": "2021-04-28T09:00:00Z",
      "updated": "2021-04-28T09:00:00Z",
      "categories": ["cs.LG", "cs.AI"],
      "links": [
        {
          "href": "http://arxiv.org/abs/2104.13478",
          "rel": "alternate",
          "type": "text/html"
        }
      ]
    }
  ]
}

get_paper

Get detailed information about a specific paper by its arXiv ID.

Parameters:

  • paper_id (string, required): arXiv paper ID (e.g., 2104.13478 or cs/0001001)

Returns: Same structured format as search_papers but for a single paper.

search_by_category

Search for papers in a specific arXiv category with pagination and sorting options.

Parameters:

  • category (string, required): arXiv category (e.g., cs.AI, physics.optics)

  • start (number, optional): Starting index for pagination (0-based)

  • max_results (number, optional): Maximum number of results to return (max 2000)

  • sort_by (string, optional): Sort by relevance, lastUpdatedDate, or submittedDate

  • sort_order (string, optional): Sort order ascending or descending

get_paper_content

Download and extract the full text content from a paper's PDF.

Parameters:

  • paper_id (string, required): arXiv paper ID (e.g., 2104.13478)

Features:

  • Downloads PDFs from arXiv's servers

  • Caches PDFs locally to avoid redundant downloads

  • Extracts and cleans text content using pdf-parse

  • Handles network errors and parsing issues gracefully

  • Returns plain text content suitable for analysis

Returns: Plain text content of the paper.

Common arXiv Categories

  • cs.AI - Artificial Intelligence

  • cs.LG - Machine Learning

  • cs.CL - Computation and Language

  • cs.CV - Computer Vision and Pattern Recognition

  • physics.optics - Optics

  • math.CO - Combinatorics

  • stat.ML - Machine Learning (Statistics)

For a complete list, see arXiv Subject Classifications.

Development

Running Tests

npm test

Build

npm run build

Watch Mode (for development)

npm run test:watch

API Reference

This server uses the official arXiv API. For more information:

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

v0.1.0 (Initial Release)

  • Basic arXiv API integration

  • Search papers by multiple criteria

  • Get individual paper details

  • Category-based search

  • PDF content extraction with caching

  • Structured JSON response parsing

  • MCP protocol implementation

Available Tools

4 tools
get_paperC

Get details about a specific paper by its arXiv ID

Inputs: paper_id (required).

get_paper_contentC

Get the full text content of a paper by downloading and extracting text from its PDF

Inputs: paper_id (required).

search_by_categoryC

Search for papers in a specific arXiv category

Inputs: category (required), start, max_results, sort_by, +1 more.

search_papersC

Search for papers on arXiv by various criteria

Inputs: query, category, author, title, +5 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 4 tools

    Disambiguation4/5

    The tools are mostly distinct, with clear purposes: get_paper retrieves metadata, get_paper_content extracts text, search_by_category filters by category, and search_papers searches by general criteria. There is some potential overlap between search_by_category and search_papers, as category could be a criterion in search_papers, but the descriptions help differentiate them by emphasizing category-specific vs. general searches.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case: get_paper, get_paper_content, search_by_category, and search_papers. The naming is predictable and readable, with no deviations in style or convention across the set.

    Tool Count4/5

    With 4 tools, the count is reasonable for an arXiv server, covering key operations like retrieving paper details, content, and searching. It is slightly under-scoped, as it lacks tools for updates, deletions, or advanced filtering, but it effectively supports core arXiv interactions without being overwhelming.

    Completeness3/5

    The tool set covers basic retrieval and search functions for arXiv papers, including metadata, content, and category-based searches. However, there are notable gaps: no tools for listing categories, handling paper versions, or managing user interactions (e.g., saving or citing papers), which limits comprehensive coverage of the arXiv domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables searching, retrieving, and parsing academic papers from arXiv, including keyword search, PDF downloads, content extraction from HTML/PDF formats, and accessing the latest AI research papers.
      4
      8 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and retrieving academic papers from arXiv by topic, allowing users to discover research papers and extract their metadata including titles, authors, abstracts, and PDF links through natural language queries.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables searching and retrieving academic papers from arXiv with support for advanced filtering by author, category, and date, plus full paper content extraction.
      12
      16
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables searching academic papers on arXiv and retrieving detailed information such as title, authors, summary, and PDF link.
      1
      6
      MIT