一个模型上下文协议（MCP）服务器，使得使用自然语言与 arXiv API 交互。

特色

• 检索托管在 arXiv.org 上的学术文章元数据
• 将文章下载到本地机器的PDF格式
• 搜索 arXiv 数据库以查找特定查询
• 检索文章并将其加载到大型语言模型（LLM）上下文中

工具

• get_article_url
• 根据标题检索 arXiv.org 托管文章的网址
• title（字符串）：文章标题
• download_article
• 下载 arXiv.org 托管的文章PDF文件
• title（字符串）：文章标题
• load_article_to_context
• 将托管在 arXiv.org 上的文章加载到LLM的上下文中
• title（字符串）：文章标题
• get_details
• 基于标题检索 arXiv.org 托管文章的元数据
• title（字符串）：文章标题
• search_arxiv
• 根据指定参数对arXiv API进行搜索查询，返回匹配的文章元数据
• all_fields（字符串）：跨所有元数据字段的通用关键词搜索
• title（字符串）：文章标题中搜索的关键词

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

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.

# Using Homebrew
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

Install development dependencies.

uv sync

Windows

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

# Use irm to download the script and execute it with iex
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Close and reopen the shell, then clone the repository.

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

Create and activate virtual environment.

uv venv --python=python3.13