arXiv MCP Server

by prashalruchiranga

40 stars
391 downloads
Not rated
GitHub

About

An MCP server that enables interacting with the arXiv API using natural language

Details

Author
prashalruchiranga
GitHub stars
40
Downloads
391
Categories
Search

- Retrieve metadata of scholarly articles from arXiv.org.
- Download articles as PDF files to the local machine.
- Search the arXiv database using natural language queries.
- Load article content into a large language model’s context.
- Access article URLs and details directly by title.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name arXiv MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install the uv package manager, create a Python 3.13 virtual environment, and run uv sync to install dependencies. Configure the server in your Claude Desktop’s claude_desktop_config.json by providing the absolute path to server.py and setting the DOWNLOAD_PATH environment variable. Once configured, you can invoke tools such as search_arxiv, get_details, download_article, or load_article_to_context via natural language prompts.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "arxiv mcp server": {
            "arxiv-server": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/ABSOLUTE/PATH/TO/PARENT/FOLDER/arxiv-mcp-server/src/arxiv_server",
                    "run",
                    "server.py"
                ],
                "env": {
                    "DOWNLOAD_PATH": "/ABSOLUTE/PATH/TO/DOWNLOADS/FOLDER"
                }
            }
        }
    }
}

McpServers

{
    "arxiv-server": {
        "command": "uv",
        "args": [
            "--directory",
            "/ABSOLUTE/PATH/TO/PARENT/FOLDER/arxiv-mcp-server/src/arxiv_server",
            "run",
            "server.py"
        ],
        "env": {
            "DOWNLOAD_PATH": "/ABSOLUTE/PATH/TO/DOWNLOADS/FOLDER"
        }
    }
}

arXiv MCP Server

MCP Compatible
Python
License
smithery badge

A Model Context Protocol (MCP) server that enables interacting with the arXiv API using natural language.

Features

- Retrieve metadata about scholarly articles hosted on arXiv.org - Download articles in PDF format to the local machine - Search arXiv database for a particular query - Retrieve articles and load them into a large language model (LLM) context

Tools

- get_article_url - Retrieve the URL of an article hosted on arXiv.org based on its title - title (String): Article title - download_article - Download the article hosted on arXiv.org as a PDF file - title (String): Article title - load_article_to_context - Load the article hosted on arXiv.org into context of a LLM - title (String): Article title - get_details - Retrieve metadata of an article hosted on arXiv.org based on its title - title (String): Article title - search_arxiv - Performs a search query on the arXiv API based on specified parameters and returns matching article metadata - all_fields (String): General keyword search across all metadata fields - title (String): Keyword(s) to search for within the titles of articles - author (String): Author name(s) to filter results by - abstract (String): Keyword(s) to search for within article abstracts - start (int): Index of the first result to return

Setup

MacOS

Clone the repository

git clone https://github.com/prashalruchiranga/arxiv-mcp-server.git
cd arxiv-mcp-server

Install uv package manager. For more details on installing, visit the official uv documentation.
```

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.