AI导哈

arXiv学术论文搜索与阅读服务

一个为AI助手提供的arXiv开放获取学术论文搜索与阅读的模型上下文协议（MCP）服务器，支持多种论文搜索、阅读和下载功能。

  • by Traves-Theberge
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Traves-Theberge/arXiv-mcp

使用说明

arXiv MCP服务器

一个模型上下文协议（MCP）服务器，为人工智能助手提供无缝的编程接口，用于从开放获取中搜索和阅读学术论文 arXiv 存储库。

该项目是人工智能优化的，这意味着返回的数据经过精心格式化，以保持在上下文窗口内，并准确提供高效、无幻觉研究所需的大型语言模型。

文档

  • API文档重点：arXiv API工具、参数和速率限制保护的详细细分。
  • 客户端配置：在不同AI客户端上运行此服务器的其他示例。
  • 代理技能包：一位官员 agentskills.io 合规的指令配置文件，教人工智能助手最有效的方法来链接这些 arxiv_* MCP工具。

功能和工具

  • arxiv_search：快速发现工具。传递搜索字符串（如 "quantum gravity")并获得一个轻量级的ID、标题和作者列表。
  • arxiv_search_trending_papers：检索特定类别的最新论文，不使用关键字。
  • arxiv_search_related_papers：语义发现工具，用于查找与特定主题相关的论文 paper_id.
  • arxiv_get_paper_details：深度阅读工具。传递论文ID以检索Markdown格式整齐的完整摘要、类别和作者元数据。
  • arxiv_get_paper_summary：提供一个AI就绪的提示包装器，用于快速生成论文、方法和局限性的摘要。
  • arxiv_get_paper_citations：为任何论文生成BibTeX、APA或MLA格式的格式完美的引文。
  • arxiv_download_paper：直接集成工具。传递纸张ID和本地系统路径，让MCP服务器自动将完整的PDF下载到您的机器上。

安装

此服务器是用TypeScript编写的，通过以下方式运行 node.

  1. 克隆此仓库 （或通过您首选的软件包管理器安装）。
  2. 安装依赖项:
    npm install
  3. 构建TypeScript项目:
    npm run build

用法

此服务器通过标准输入/输出进行通信(stdio).你可以通过Node原生集成它，也可以使用Docker完全隔离地运行它。

原生Node.js

在MCP客户端中使用以下命令配置：

node /path/to/arxic-mcp/build/index.js

码头工人

我们提供基于Alpine的轻质集装箱。首先，建立形象：

docker build -t arxic-mcp .

然后，使用以下命令配置运行MCP客户端：

docker run -i --rm -v /home/user/Downloads:/home/user/Downloads arxic-mcp

（注：通过 -v 确保 download_pdf 该工具有权将文件保存到本地主机！)

客户端配置

您可以将此服务器添加到任何兼容MCP的客户端。

重要：替换 /absolute/path/to/ 使用系统上的实际路径。

选项1:Docker（推荐）

这种方法确保了 arxiv_download_paper 该工具有权通过以下方式将PDF保存到您的计算机 -v 卷装载。由于Docker在不同操作系统中处理权限的方式不同，请为您的计算机使用正确的配置：

Linux/macOS

如果您使用Mac或Linux，则必须传递您的用户名 -u 1000:1000 （或 501:20 对于某些Mac电脑），因此下载的PDF不会被锁定为 root 文件。

{
  "mcpServers": {
    "arxic-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-u",
        "1000:1000",
        "-v",
        "/Users/yourname/Downloads:/Users/yourname/Downloads", 
        "arxic-mcp"
      ]
    }
  }
}

Windows（WSL2/Docker桌面）

Windows Docker Desktop通常会自动处理文件挂载转换。您可以放心地省略用户ID标志，但一定要使用正确的 /c/Users/... 或WSL绝对路径格式。

{
  "mcpServers": {
    "arxic-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/c/Users/yourname/Downloads:/c/Users/yourname/Downloads", 
        "arxic-mcp"
      ]
    }
  }
}

选项2：原生Node.js

如果你更喜欢在没有Docker的情况下原生运行：

{
  "mcpServers": {
    "arxic-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/arxic-mcp/build/index.js"
      ]
    }
  }
}

专业提示：本机运行启用 arxiv_download_paper 将PDF保存到 任何 实际系统上的文件夹（如 ~/Downloads)，无需配置复杂的卷装载！

IDE特定说明

  • 反重力：将上面的JSON块添加到您的本地 .gemini/ 配置文件。
  • 克劳德桌面版：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （Mac）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）。
  • 光标：导航到“设置”>“功能”>“MCP服务器”。使用上述原始命令添加新的命令服务器（例如。， node /path/to/index.js).
  • 克劳德代码（CLI）：运行 claude mcp add arxic-mcp -- node /absolute/path/to/arxic-mcp/build/index.js
  • 帆板运动：添加到 ~/.codeium/windsurf/mcp_config.json
  • 泽德：添加到 settings.json 在...之下 "experimental.mcp"

归因

感谢arXiv使用其开放访问互操作性。 该项目承认并尊重arXiv团队及其支持的科学界的辛勤工作。

许可证

麻省理工学院

制作❤️ 通过特拉维斯Theberge

相关 MCP