ArXiv MCP 服务器

🔍 让 AI 助手通过简单的 MCP 接口搜索和访问 arXiv 论文。

ArXiv MCP 服务器通过模型上下文协议 (MCP) 在 AI 助手与 arXiv 的研究库之间架起桥梁。它允许 AI 模型以编程方式搜索论文并访问其内容。

✨ 核心功能

• 🔎 论文搜索：按日期范围和类别筛选查询 arXiv 论文
• 📄 论文访问：下载并阅读论文内容
• 📋 论文列表：查看所有已下载的论文
• 🗃️ 本地存储：论文保存在本地以便快速访问
• 📝 提示：一组用于论文分析的研究提示

🔒 安全性

提示注入风险

从 arXiv 获取的论文内容是不可信的外部输入。

当 AI 助手通过此服务器下载或阅读论文时，论文文本会直接传递到模型的上下文中。恶意构造的论文可能嵌入旨在劫持 AI 行为的对抗性指令——例如，指示它泄露数据、以非预期参数调用其他工具，或覆盖系统级指令。这是一种已知的攻击类型，被 OWASP 描述为 LLM01：提示注入，也被 OWASP Agentic AI 框架描述为 AG01：集成 LLM 系统中的提示注入。

推荐的缓解措施

1. 使用只读 MCP 配置——在可能的情况下，配置 MCP 客户端，使 arxiv-mcp-server 无法触发写操作或代表您调用其他工具。
2. 在根据 AI 总结采取行动前审查论文内容——如果 AI 总结要求您运行命令或访问不在您原始请求之内的外部 URL，则应将其视为危险信号。
3. 在多工具设置中保持谨慎——将此服务器与文件系统、Shell 或浏览器工具结合使用的代理式流程风险更高；论文中的提示注入可能会意外地串联工具调用。
4. 将 AI 生成的摘要视为数据，而非指令——在执行 AI 阅读论文后推荐的任何操作之前，务必运用人类判断。

参考文献

• OWASP LLM01：提示注入
• OWASP Agentic AI - AG01：提示注入

---

🚀 快速入门

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude Desktop 的 ArXiv 服务器：

npx -y @smithery/cli install arxiv-mcp-server --client claude

手动安装

重要——请使用 uv tool install，而不是 uv pip install

运行 uv pip install arxiv-mcp-server 会将该包安装到当前虚拟环境中，但不会将 arxiv-mcp-server 可执行文件放置在您的 PATH 上。您必须使用 uv tool install，这样 uv 才能创建一个隔离环境并将可执行文件全局暴露：

uv tool install arxiv-mcp-server

此后，arxiv-mcp-server 命令将在您的 PATH 上可用。

PDF 备用（较旧的论文）： 大多数 arXiv 论文都有 HTML 版本，基础安装会自动处理。对于仅提供 PDF 的较旧论文，服务器需要 [pdf] 附加组件（pymupdf4llm）。请使用以下命令安装：

uv tool install 'arxiv-mcp-server[pdf]'

您可以通过以下命令进行验证：

arxiv-mcp-server --help

如果您之前运行过 uv pip install arxiv-mcp-server 而命令仍然缺失，请先卸载，然后按照上述说明使用 uv tool install 重新安装。

用于开发：

# 克隆并设置开发环境
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装包含测试依赖项的包（仅用于开发——不会生成全局可执行文件）
uv pip install -e ".[test]"

🔌 MCP 集成

将以下配置添加到你的 MCP 客户端配置文件中：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

用于开发环境：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

🔒 安全提示

arXiv 上的论文是由用户生成的不受信任的内容。该服务器返回的论文文本可能包含提示注入尝试——即经过精心设计的文本，旨在操纵 AI 助手的行为。请将所有论文内容视为不可信输入。

在生产环境中，请采取适当的沙箱隔离措施，并避免在未经审查的情况下将原始论文内容输入到可访问敏感工具或数据的代理型工作流中。完整的安全策略请参阅 SECURITY.md。

💡 可用工具

核心工作流程

深度论文研究的典型工作流程如下：

search_papers → download_paper → read_paper

list_papers 会显示你本地已有的论文。semantic_search 则会在你的本地文献库中进行语义搜索。

---

1. 论文搜索

使用可选的类别、日期和布尔过滤器在 arXiv 上进行搜索。系统会自动执行 arXiv 的 3 秒限速规则。如果被限速，请等待 60 秒后再重试。

result = await call_tool("search_papers", {
    "query": "\"KAN\" OR \"Kolmogorov-Arnold Networks\"",
    "max_results": 10,
    "date_from": "2024-01-01",
    "categories": ["cs.LG", "cs.AI"],
    "sort_by": "date"   # 或 "relevance"（默认）
})

支持的类别包括 cs.AI、cs.LG、cs.CL、cs.CV、cs.NE、stat.ML、math.OC、quant-ph、eess.SP 等。完整列表请参阅工具描述。

2. 论文下载

通过 arXiv ID 下载论文。优先尝试 HTML 格式，若不可用则回退至 PDF。下载后的论文会存储在本地，供后续的 read_paper 和 semantic_search 使用。

result = await call_tool("download_paper", {
    "paper_id": "2401.12345"
})

对于仅提供 PDF 格式的旧论文，需安装 [pdf] 扩展：uv tool install 'arxiv-mcp-server[pdf]'

3. 列出论文

列出所有已下载到本地的论文。仅返回 arXiv ID——如需访问内容，请使用 read_paper。

result = await call_tool("list_papers", {})

4. 阅读论文

以 Markdown 格式阅读本地已下载论文的全文。必须先调用 download_paper。

result = await call_tool("read_paper", {
    "paper_id": "2401.12345"
})

📝 研究提示

该服务器提供专门的提示，帮助分析学术论文：

论文分析提示

这是一个全面的学术论文分析工作流，只需提供论文 ID 即可：

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

此提示包括：

• 使用可用工具（list_papers、download_paper、read_paper、search_papers）的详细说明
• 系统化的论文分析流程
• 包含以下内容的综合分析框架：
  • 执行摘要
  • 研究背景
  • 方法论分析
  • 结果评估
  • 实践与理论意义
  • 未来研究方向
  • 更广泛的影响
• 未来研究方向
• 更广泛的影响

Pro 提示包

• summarize_paper：针对单篇论文的简洁结构化摘要。
• compare_papers：跨论文 ID 的并列技术比较。
• literature_review：围绕特定主题及可选论文集的主题综述。

⚙️ 配置

可通过环境变量进行配置：

变量	用途	默认值
ARXIV_STORAGE_PATH	论文存储位置	~/.arxiv-mcp-server/papers

🧪 测试

运行测试套件：

python -m pytest

🧪 实验性功能

这些功能尚未完全测试，可能会出现意外行为。请谨慎使用。

以下工具需要额外依赖项，目前仍在积极开发中：

uv pip install -e ".[pro]"

语义搜索

仅对您本地下载的论文进行语义相似度搜索。如果尚未下载任何论文，则返回空结果。需要 [pro] 依赖项。

result = await call_tool("semantic_search", {
    "query": "多模态 Transformer 中的测试时适应",
    "max_results": 5
})
# 或查找与已知论文相似的论文：
result = await call_tool("semantic_search", {
    "paper_id": "2404.19756",
    "max_results": 5
})

引文图

通过 Semantic Scholar 获取参考文献和引用论文。适用于任意 arXiv ID——无需本地下载。

result = await call_tool("citation_graph", {
    "paper_id": "2401.12345"
})

研究提醒

保存主题监控，并定期轮询自上次检查以来新发表的论文。查询语法与 search_papers 相同。

# 注册监控（幂等操作——再次调用会更新现有监控）
await call_tool("watch_topic", {
    "topic": "\"多智能体强化学习\"",
    "categories": ["cs.AI", "cs.LG"],
    "max_results": 10
})

# 检查所有监控——仅返回自上次检查以来新发表的论文
result = await call_tool("check_alerts", {})

# 检查单个监控
result = await call_tool("check_alerts", {"topic": "\"多智能体强化学习\""})

高级提示

summarize_paper、compare_papers 和 literature_review 用于更深入的研究工作流。需要 [pro] 依赖项。

---

📄 许可证

本项目采用 MIT 许可证发布。详情请参阅 LICENSE 文件。

---

arxiv-mcp-server 快速上手指南

arxiv-mcp-server 是一个基于模型上下文协议（MCP）的工具，允许 AI 助手直接搜索、下载并阅读 arXiv 上的学术论文。它支持本地存储论文以加速访问，并提供了一系列用于论文分析的预设提示词。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统: Linux, macOS 或 Windows (WSL)
• Python 版本: Python 3.11 或更高版本
• 包管理器: 推荐安装 uv (高性能 Python 包安装器和运行时)。
  • 安装 uv (Linux/macOS): curl -LsSf https://astral.sh/uv/install.sh | sh
  • 安装 uv (Windows PowerShell): powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
• MCP 客户端: 已配置好 MCP 的 AI 编辑器或客户端（如 Claude Desktop, VS Code + MCP 插件等）。

注意：本工具强烈建议使用 uv tool 进行安装，而非传统的 pip，以确保可执行命令正确添加到系统路径中。

安装步骤

1. 安装核心功能

使用 uv 将服务器安装为全局工具：

uv tool install arxiv-mcp-server

安装完成后，您可以通过以下命令验证安装是否成功：

arxiv-mcp-server --help

2. 可选：安装 PDF 支持

默认情况下，工具优先抓取论文的 HTML 版本。如果您需要阅读仅包含 PDF 的旧论文，请安装带有 [pdf] 额外依赖的版本：

uv tool install 'arxiv-mcp-server[pdf]'

3. 配置 MCP 客户端

根据您的 MCP 客户端配置文件（通常为 claude_desktop_config.json 或 VS Code 的 settings.json），添加以下配置项。

标准配置示例：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage" 
            ]
        }
    }
}

• --storage-path: 指定论文本地存储路径（可选），默认为 ~/.arxiv-mcp-server/papers。请将其替换为您实际的目录路径。

基本使用

安装并配置完成后，您可以在支持的 AI 助手（如 Claude）中直接使用自然语言指令，或通过代码调用工具。

典型工作流

最常用的研究流程是：搜索 -> 下载 -> 阅读。

1. 搜索论文

您可以让 AI 助手搜索特定主题、日期范围或分类的论文。

• 自然语言指令示例: "帮我搜索 2024 年以来关于 'Kolmogorov-Arnold Networks' 的机器学习论文，限制结果为 5 篇。"
• 底层工具调用逻辑:

  # 内部调用 search_papers 工具
  result = await call_tool("search_papers", {
      "query": "\"KAN\" OR \"Kolmogorov-Arnold Networks\"",
      "max_results": 5,
      "date_from": "2024-01-01",
      "categories": ["cs.LG", "cs.AI"],
      "sort_by": "date"
  })
  

2. 下载论文

获取到论文 ID（例如 2401.12345）后，下载全文到本地。

• 自然语言指令示例: "下载这篇论文：2401.12345"
• 底层工具调用逻辑:

  result = await call_tool("download_paper", {
      "paper_id": "2401.12345"
  })
  

3. 阅读与分析

下载完成后，读取内容并进行分析。

• 自然语言指令示例: "阅读刚才下载的论文，并总结其核心方法和实验结果。"
• 底层工具调用逻辑:

  # 读取全文
  content = await call_tool("read_paper", {
      "paper_id": "2401.12345"
  })
  
  # 或者直接使用内置的深度分析提示词
  analysis = await call_prompt("deep-paper-analysis", {
      "paper_id": "2401.12345"
  })
  

⚠️ 安全提示

arXiv 论文属于用户生成的不可信内容。恶意论文可能包含**提示词注入（Prompt Injection）**攻击，试图操纵 AI 的行为。

• 请勿在未审查的情况下，让 AI 根据论文内容直接执行系统命令或访问敏感数据。
• 将 AI 生成的论文摘要视为“数据”而非“指令”，在执行任何操作前保持人工判断。