🧠 arXiv Research Assistant MCP Server

🧠 arXiv Research Assistant MCP Server

site icon
2025.04.22 0
Python论文搜索学术研究AI辅助工具内容生成开发效率
arXiv Research Assistant MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,旨在与 arXiv.org 论文数据库进行交互。它允许客户端(如 Claude AI)通过本地服务器高效地搜索、探索和比较 arXiv 论文。该项目使用 Python 和 FastMCP 框架构建,并利用 uv 进行轻量级包管理。
View on GitHub

Overview

✨ 核心功能

  • 🔍 基于关键词的论文搜索:通过关键词搜索 arXiv 论文,可按相关性或最新排序。
  • 📚 按类别获取最新论文:指定 arXiv 类别代码(如 cs.AImath.AP)获取该领域的最新论文。
  • 📄 论文详细信息查询:使用 arXiv ID 获取论文的详细元数据,包括标题、作者、摘要、类别、DOI、PDF 链接等。
  • 🧑‍🔬 基于作者的论文搜索:检索特定作者发表的论文列表。
  • 📊 趋势分析(实验性):基于某个类别的最新论文获取关键词或主题的趋势概览(目前使用模拟数据)。
  • 📝 摘要提示生成器:动态生成提示,帮助 LLMs 更有效地总结选定的论文。
  • 🆚 比较提示生成器:提供两个论文 ID,生成用于比较其内容的结构化提示。

🛠️ 技术栈

  • Python 3.11+
  • FastMCP
  • uv(用于依赖和环境管理)
  • requests(用于 API 通信)
  • xml.etree.ElementTree(用于解析 XML 响应)

🚀 使用教程

1. 从 PyPI 安装

pip install arxiv-paper-mcp
# 或使用 uv
uv install arxiv-paper-mcp

2. 克隆仓库(用于开发)

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

3. 安装依赖(用于开发)

使用 uv 以可编辑模式安装所有依赖:

uv pip install -e .

⚙️ 如何运行

▶️ 本地运行服务器

uv run mcp dev arxiv_mcp/server.py

🔌 与 Claude 一起使用

将此 MCP 服务器与 Claude 一起使用,将以下 JSON 配置添加到 Claude 的 MCP 设置中:

{
  "arXivPaper": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "arxiv-paper-mcp>=0.1.0",
      "arxiv-mcp"
    ]
  }
}

项目结构

arxiv-mcp-server/
├── arxiv_mcp/              # 主包
│   ├── __init__.py
│   ├── app.py              # FastMCP 应用设置
│   ├── server.py           # 服务器入口点
│   ├── utils.py            # arXiv API 通信逻辑
│   ├── resources/          # MCP 资源(类别、作者等)
│   ├── tools/              # MCP 工具(搜索、详细查询、趋势)
│   └── prompts/            # 提示模板(总结、比较)
├── pyproject.toml          # 项目配置和依赖
└── README.md               # 本文件

许可证

该项目遵循 None 开源许可条款。