mcpField
P
paper-search

paper-search

github.com/openags生产力2.9k218 次安装4 周前更新
代码仓库

关于 paper-search

用于搜索、下载学术论文并提取文本的命令行工具，支持从配置的信息源中检索。研究人员可选择来源进行论文发现，也可从命令行调用 MCP 工具。

主要功能

  1. 01跨学术信息源搜索
  2. 02下载论文 PDF
  3. 03提取论文文本
  4. 04按来源和年份筛选
  5. 05从命令行调用已注册的 MCP 工具

适用场景

  1. 01在选定索引中查找论文
  2. 02保存 PDF 以便离线阅读
  3. 03提取论文文本进行审阅
  4. 04查询引用或被引用论文

MCP 相关

项目提供论文搜索及关联查询的 MCP 工具，命令行也可调用相同的已注册工具并设置来源选项。可用工具取决于当前配置。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openags/paper-search-mcp --skill paper-search

安装后在 Claude Code 中输入/paper-search确认已加载。

详细介绍

论文搜索

通过 paper-search CLI 搜索、下载和阅读学术论文。

CLI 用法

所有命令均通过以下方式运行：

paper-search <command> [args]

如果 paper-search 不可用，请使用 uv tool install paper-search-mcp 安装。可在 ~/.config/paper-search-mcp/.env 中配置可选 API 密钥。

搜索
paper-search search "<query>" -n <max_per_source> -s <sources> -y <year>
  • -n：每个来源的结果数（默认：5）
  • -s：以逗号分隔的来源、"fast"、"fastest" 或 "all"（默认：all）
  • --exhaustive：兼容性空操作（默认已执行广泛搜索）；显式指定的 -s 始终优先
  • -y：Semantic Scholar 的年份筛选（例如 "2020"、"2018-2022"）

如需加快速度，请使用 -s fast（OpenAlex、Crossref、arXiv、PubMed、Europe PMC；如果 Semantic Scholar 的 API 密钥非空，也会使用它），或使用 -s fastest（OpenAlex 和 Crossref）。即使查询 DOI，也不会扩展显式指定的来源。DOI 查询请使用 -s unpaywall；"all" 已包含它。这些预设不会启用可选的付费来源。

下载 PDF
paper-search download <source> <paper_id> [-o ./downloads]
阅读（提取文本）
paper-search read <source> <paper_id> [-o ./downloads]
列出来源
paper-search sources
通过 CLI 调用 MCP 工具

paper-search tool 会调用与 MCP 服务相同的已注册工具，包括特定来源的选项和 DOI 查询。必填参数采用位置参数； 可选参数使用 kebab-case 标志。布尔标志使用 --flag 和 --no-flag；省略的选项会保留其 MCP 默认值。

paper-search tool --help
paper-search tool --list  # JSON tool list, schemas, and annotations
paper-search tool search_crossref --help
paper-search tool search_crossref "transformer attention" --filter from-pub-date:2024-01-01 --sort published --order desc --max-results 2
paper-search tool get_crossref_paper_by_doi 10.1038/nature12373
paper-search tool search_iacr "cryptography" --no-fetch-details

对象和列表以 JSON 返回；文本和下载路径以纯文本返回。发生异常时会返回 JSON 错误，并以退出代码 1 结束；CLI 语法无效时以退出代码 2 结束。正常的 MCP 结果保留其原始含义，包括工具本身返回的错误或部分结果字段。--list 仅显示当前配置启用的工具，因此 IEEE 工具仍需其 API 密钥。现有的 search、download、read 和 sources 命令保持不变。工具调用保留 MCP 工具的来源选择和超时行为；Sci-Hub 回退仍需通过 --use-scihub 显式启用。

输出

search 和 download 返回 JSON。read 返回纯文本。配置警告会输出到 stderr，可忽略。

来源

arxiv、pubmed、biorxiv、medrxiv、google_scholar、iacr、semantic、crossref、openalex、pmc、core、europepmc、dblp、openaire、citeseerx、doaj、base、zenodo、hal、ssrn、openreview、unpaywall、acm

可选项（环境变量）：ieee（IEEE_API_KEY）。ACM 搜索无需密钥，并使用 Crossref 元数据；访问出版商 PDF 时可能需要 OA 回退。

Web of Science（wos）和 Scopus（scopus）需要相应的运行时 API 密钥并且必须显式选择来源；它们不会被加入 all、fast 或 fastest。 在普通搜索中使用 --wos-db 或 --scopus-view、--scopus-sort、--scopus-field 和 --scopus-date 选项，也可以查看对应工具的帮助信息。read scopus <id> 会返回结构化摘要元数据；--full-text 会显式尝试获取通过身份验证的文章正文，如果仍无法获取全文，则返回非零退出码。仅含摘要的结果不属于全文。

工具命令还提供 get_citing_papers、get_referenced_papers、 get_search_cache_status 和 clear_search_cache。关系查询接受 DOI/OpenAlex ID，并会进行有界的单跳检索。缓存默认关闭； 启用后会持久化查询和公开结果，并且必须由操作者明确选择。清除搜索缓存不会删除已下载的 PDF。

工作流

  1. 使用针对性来源搜索论文
  2. 以表格形式呈现结果：标题、作者、年份、来源、DOI/URL
  3. 如果用户需要全文，使用 read <source> <paper_id>
  4. 如果用户需要 PDF，使用 download <source> <paper_id> 并报告保存路径

评论

支持 Markdown