Arxiv Search Mcp Server

arXiv Search MCP 服务

一个 MCP（Model Context Protocol）服务，使用官方 arXiv API 为 arXiv.org 论文提供搜索功能。

功能

• 按词搜索：按标题、摘要和正文中的关键词搜索论文
• 主题筛选：按 arXiv 主题类别筛选结果（physics、cs、math 等）
• 日期范围筛选：按提交日期范围筛选论文
• 可配置结果数量：控制返回的结果数量（最多 2000 条）
• 包含 PDF URL：提供论文 PDF 的直接链接，方便访问
• 全面的元数据：作者姓名、摘要、类别、发布日期等

安装

从 PyPI 安装（推荐）

pip install arxiv-search-mcp-server

从源代码安装

1. 克隆仓库：

git clone https://github.com/gavinHuang/arxiv-search-mcp.git
cd arxiv-search-mcp

2. 安装软件包：

pip install -e .

使用方法

运行服务

作为 CLI 命令运行（pip install 后）

arxiv-search-mcp

作为 Python 模块运行

python -m arxiv_search_mcp.server

从源代码运行

python src/arxiv_search_mcp/server.py

可用工具

1. search_arxiv_papers

在 arXiv 上搜索论文，并使用各种筛选选项。

参数：

• terms（必填）：要在论文标题、摘要和正文中查找的搜索词
• subject（可选）：用于筛选的主题类别（请参阅下方的可用类别）
• start_date（可选）：筛选论文的起始日期，格式为 YYYY-MM-DD
• end_date（可选）：筛选论文的结束日期，格式为 YYYY-MM-DD
• max_results（可选）：返回的最大结果数量（默认值：10，最大值：2000）

示例：

search_arxiv_papers(
    terms="quantum computing",
    subject="quant-ph",
    start_date="2023-01-01",
    end_date="2023-12-31",
    max_results=20
)

2. get_subject_categories

获取可用于筛选的主题类别列表。

**返回值：**类别代码及其描述组成的字典。

可用主题类别

• physics - 物理学（通用）
• astro-ph - 天体物理学
• cond-mat - 凝聚态物理
• gr-qc - 广义相对论与量子宇宙学
• hep-ex - 高能物理——实验
• hep-lat - 高能物理——格点
• hep-ph - 高能物理——唯象学
• hep-th - 高能物理——理论
• math-ph - 数学物理
• nlin - 非线性科学
• nucl-ex - 核实验
• nucl-th - 核理论
• quant-ph - 量子物理
• math - 数学
• cs - 计算机科学
• econ - 经济学
• eess - 电气工程与系统科学
• stat - 统计学
• q-bio - 定量生物学
• q-fin - 定量金融学

响应格式

每篇论文的搜索结果均包含以下信息：

{
  "arxiv_id": "2301.12345",
  "title": "Paper Title",
  "authors": ["Author 1", "Author 2"],
  "abstract": "Paper abstract...",
  "categories": ["cs.LG", "cs.AI"],
  "published_date": "2023-01-15",
  "pdf_url": "http://arxiv.org/pdf/2301.12345v1",
  "arxiv_url": "http://arxiv.org/abs/2301.12345",
  "comment": "Author comments",
  "journal_ref": "Journal reference if available",
  "doi": "DOI if available"
}

API 限制

• 每个请求最多返回 2000 条结果（arXiv API 的限制）
• 速率限制：请合理调用 API（arXiv 建议批量操作时请求间隔为 3 秒）
• 默认按相关性返回结果

错误处理

服务可处理各种错误情况：

• 无效的搜索参数
• 网络连接问题
• arXiv API 错误
• 格式错误的响应

错误将以结构化格式返回，并附有描述性消息。

依赖项

• fastmcp - MCP 服务框架
• requests - 用于调用 arXiv API 的 HTTP 客户端
• feedparser - Atom/RSS 源解析
• urllib3 - URL 处理工具

许可证

本项目遵循 arXiv API 使用条款。请尊重 arXiv 的资源，并负责任地使用 API。