arXiv MCP Server

arXiv MCP Server

一个 Model Context Protocol（MCP）服务，可使用自然语言与 arXiv API 交互。

功能

• 获取托管在 arXiv.org 上的学术文章的元数据
• 将文章以 PDF 格式下载到本地设备
• 在 arXiv 数据库中搜索指定内容
• 获取文章并将其加载到大模型的上下文中

工具

• get_article_url
  • 根据文章标题获取托管在 arXiv.org 上的文章 URL
    • title（String）：文章标题
• download_article
  • 将托管在 arXiv.org 上的文章下载为 PDF 文件
    • title（String）：文章标题
• load_article_to_context
  • 将托管在 arXiv.org 上的文章加载到大模型的上下文中
    • title（String）：文章标题
• get_details
  • 根据文章标题获取托管在 arXiv.org 上的文章元数据
    • title（String）：文章标题
• search_arxiv
  • 根据指定参数在 arXiv API 中执行搜索，并返回匹配文章的元数据
    • all_fields（String）：在所有元数据字段中搜索通用关键词
    • title（String）：在文章标题中搜索的关键词
    • author（String）：用于筛选结果的作者姓名
    • abstract（String）：在文章摘要中搜索的关键词
    • start（int）：要返回的第一条结果的索引

设置

MacOS

克隆代码仓库

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

安装 uv 包管理器。有关安装的更多详情，请参阅uv 官方文档。

# Using Homebrew
brew install uv

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

创建并激活虚拟环境。

uv venv --python=python3.13
source .venv/bin/activate

安装开发依赖项。

uv sync

Windows

安装 uv 包管理器。有关安装的更多详情，请参阅uv 官方文档。

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

关闭并重新打开 Shell，然后克隆代码仓库。

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

创建并激活虚拟环境。

uv venv --python=python3.13
source .venv\Scripts\activate

安装开发依赖项。

uv sync

在 Claude Desktop 中使用

要启用此集成，请将服务配置添加到 claude_desktop_config.json 文件中。如果文件不存在，请先创建。

MacOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json Windows 路径：%APPDATA%/Roaming/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"
      }
    }
  }
}

你可能需要在 command 字段中填写 uv 可执行文件的完整路径。在 MacOS 上运行 which uv，或在 Windows 上运行 where uv，即可获取该路径。

示例提示词

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

许可证

根据 MIT 许可证授权。请参阅 LICENSE。