arXiv API

What is arxiv-mcp-server?

arxiv-mcp-server is a Model Context Protocol (MCP) server that facilitates natural language interaction with the arXiv API. It allows users to retrieve information, download articles, and search the arXiv database using conversational commands.

How to use arxiv-mcp-server?

To use arxiv-mcp-server, you first need to install it. This involves cloning the repository, installing the uv package manager, creating and activating a virtual environment, and then installing development dependencies. Once set up, you can integrate it with applications like Claude Desktop by configuring the claude_desktop_config.json file with the server command and arguments, including the path to the server and an optional download path.

Key Features of arxiv-mcp-server

• Retrieve Metadata: Obtain metadata about scholarly articles hosted on arXiv.org.
• Download Articles: Download articles in PDF format to your local machine.
• Search arXiv Database: Perform searches on the arXiv database for specific queries.
• Load Articles to LLM Context: Retrieve articles and load them directly into a large language model (LLM) context.
• Tools: Provides specific tools like get_article_url (to get article URLs by title), download_article (to download articles by title), load_article_to_context (to load articles into LLM context by title), get_details (to retrieve article metadata by title), and search_arxiv (to perform detailed searches by various parameters like all_fields, title, author, abstract, and start index).

Use Cases of arxiv-mcp-server

• Academic Research: Quickly find and access scholarly articles on arXiv.
• Content Integration: Integrate arXiv content directly into LLMs for analysis or summarization.
• Automated Downloads: Automate the download of research papers for offline reading or archival.
• Natural Language Queries: Interact with the arXiv API using natural language, simplifying the search and retrieval process for non-technical users or for integration into conversational AI systems.

FAQ about arxiv-mcp-server

• What is MCP? MCP stands for Model Context Protocol, which enables natural language interaction with APIs.
• What are the system requirements? Python 3.13+ is required.
• How do I install uv? You can install uv using Homebrew on macOS or via a curl script for other systems.
• Can I use it with other applications besides Claude Desktop? While the example focuses on Claude Desktop, the server can potentially be integrated with any application that supports MCP servers by configuring the command and arguments appropriately.
• How do I specify the download path for articles? You can set the DOWNLOAD_PATH environment variable in your MCP server configuration.

arXiv MCP Server

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

Manual Installation

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 on other operating systems, visit the official uv documentation.

# Using Homebrew for macOS
brew install uv

# or
curl -LsSf https://astral.sh/uv/install.sh | sh

Create and activate virtual environment.

uv venv --python=python3.13
source .venv/bin/activate   # or `venv\Scripts\activate` on Windows

Install development dependencies.

uv sync

Usage with Claude Desktop

To enable this integration, add the server configuration to your claude_desktop_config.json file. Make sure to create the file if it doesn’t exist.

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "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"
      }
    }
  }
}

You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS or where uv on Windows.

Example Prompts

Can you get the details of 'Reasoning to Learn from Latent Thoughts' paper?

Get the papers authored or co-authored by Yann Lecun on convolutional neural networks

Download the attention is all you need paper

Can you get the papers by Andrew NG which have 'convolutional neural networks' in title?

Can you display the paper?

List the titles of papers by Yann LeCun. Paginate through the API until there are 30 titles

License

Licensed under MIT. See the LICENSE.