这个工具提供了哪些能力
点开任一能力,看清怎么用
每个能力展开后是三件事:它会给你什么、你需要准备什么、哪些必须由你把关。
常见场景:需要让AI助手直接搜索和获取arXiv论文全文时;需要在本地构建已读论文的语义检索索引时;需要按类别、日期范围和排序过滤arXiv论文时
覆盖阶段文献
帮你快速查 arXiv 上的论文:可以用日常语言或专业检索式搜索,按学科类别和日期范围筛选排序,拿到一份带标题、作者、摘要和链接的候选清单;也能按编号单独调出一篇的摘要,先判断值不值得下载。
它会给你什么
- 一份候选论文清单和总命中数,每条含编号、标题、作者、摘要、类别、发表时间和链接。
- 单篇论文的摘要信息,含 PDF 链接。
- 注意:只覆盖 arXiv 这一个来源,候选只是线索,不代表已核实。
你需要准备
- 搜索词,可以用普通短语,也可以用字段限定和与或非组合。
- 最多返回多少条结果,默认十条,上限五十。
- 只看这个日期之后发表的论文。
由你把关
- 多个任务同时查询时是否守住了 arXiv 每三秒一次的限速要求,由你核对。
- 被限流后等待一分钟再重试的做法是否可靠,由你核对。
- 两种检索路径在不开日期过滤时结果是否一致,由你核对。
帮你在一批已下载的论文里按意思找文献:你可以用一句话描述要找的内容,或指定一篇论文让它推荐相似的论文,结果按相似程度排序;前提是论文已经下载到本地。
它会给你什么
- 一份按相似度排序的论文清单,含标题、作者、摘要和得分。
- 一份重建索引的结果报告,含成功、失败和论文总数。
- 注意:只检索本地已下载的论文,相似度得分只是排序参考,不等于相关性结论。
你需要准备
- 一句话描述你想找的内容。
- 一篇已知论文的编号,用来找相似论文。
- 最多返回多少条结果。
由你把关
- 检索所用嵌入模型的实际效果是否满足你的需要,由你核对。
- 检索只看摘要不看全文,可能漏掉正文相关但摘要不像的论文,由你核对。
- 论文很多时重建索引要花多久、占多少资源,由你核对。
帮你把论文全文抓到本地慢慢读:按编号下载论文并转成普通文本缓存,长论文可以分段阅读;也能列出已经下载了哪些论文,随时调阅。
它会给你什么
- 下载结果,含来源(缓存、网页或 PDF)、全文内容和分页信息。
- 分段读取的论文内容。
- 本地已下载论文的清单和总数。
你需要准备
- 一篇论文的 arXiv 编号。
- 从全文的第几个字符开始读。
- 这次最多读多少字。
由你把关
- 网页转文本可能丢失表格和公式格式,是否影响你的用途,由你核对。
- 走 PDF 转换路径时的文本质量是否可用,由你核对。
- 命中缓存时后台索引刷新失败是否影响使用,由你核对。
第一次这样开始
把仓库地址直接交给 AI
先让 AI 说明环境和风险,再完成最小安装验证。开始前想清楚要用哪个能力、把对应材料备在手边——每张能力卡展开后有具体清单。
第一次直接复制
帮我安装这个库:https://github.com/blazickjp/arxiv-mcp-server 安装前先告诉我需要什么环境,安装后帮我跑通一个最小示例。
别这样用
这些判断,仍然由你负责
- 把arXiv论文内容直接当作可信指令输入给AI(内容可能含恶意prompt)
- 连续大量请求触发arXiv API限速导致暂时封禁
- 用语义检索结果替代人工文献筛选和相关性判断
技术依据
查看能力拆解、验证范围与来源
技术依据
查看能力拆解、验证范围与来源
处理机制
- 01
核心处理链
让AI助手通过MCP协议搜索、下载和阅读arXiv论文
已核对范围
- 只读上游快照 本地只读快照,commit d58901760d7ede4adb162eaba1725209a933f100
- src/arxivmcpserver/tools/search.py(handlesearch、rawarxivsearch、parsearxivatomresponse、ratelimitedget、validatecategories、optimizequery、searchtool schema)
- src/arxivmcpserver/tools/getabstract.py(handlegetabstract、abstracttool schema)
- src/arxivmcpserver/config.py(Settings、getarxivclient)
- README.md(Paper Search 段、Available Tools)
- src/arxivmcpserver/tools/semanticsearch.py(handlesemanticsearch、semanticsearchtool/reindextool schema、connect、getmodel、embedtext、upsertindexrecord、loadvectors、rankbysimilarity、getindexedpapervector、indexpaperbyid、indexpaperfromresult、rebuildindex、IndexedPaper dataclass)
- src/arxivmcpserver/tools/download.py(runindexbyid/runindexfromresult 后台索引触发,getindexsemaphore 串行化)
- src/arxivmcpserver/tools/listpapers.py(isvalidarxivid 用于 rebuildindex 筛选)
仍待核对
- 未调用真实 arXiv API
- 未验证 rawarxivsearch 的日期范围 URL 编码在实际查询中的正确性
- 未验证 429/503 限速的实际触发与 60s 等待建议的准确性
- 未验证 arxiv Python 包路径与 raw HTTP 路径在无日期过滤时的结果差异
- 未安装 [pro] extra(sentence-transformers/numpy)
- 未运行语义检索或索引
- 未验证嵌入模型 all-MiniLM-L6-v2 的实际维度与检索质量
- 未验证 SQLite 向量存储的查询性能
读取版本
d58901760d7ede4adb162eaba1725209a933f100许可
Apache-2.0
最近核对
内容 2026-07-10
Stars 2026-07-11
已完成源码核对
相关文章
科研之我见
如何从 300 篇候选文献中筛出 50 篇核心文献
把文献检索与筛选拆开,通过本地文献库、Zotero、外部数据库和引文追踪形成可回查的核心文献清单。
查看内容