Paper Search 是一个用于检索、下载和阅读学术论文的命令行工具，通过 paper-search CLI 使用。
用途
Paper Search 主要用于在多个学术来源中查找论文，并进一步获取全文或 PDF。资料描述其使用场景为：当用户要求查找论文、搜索相关研究时使用。
安装与配置
所有命令通过以下形式运行：
paper-search <command> [args]
如果 paper-search 不可用，可用以下命令安装：
uv tool install paper-search-mcp
可选的 API 密钥可配置在 ~/.config/paper-search-mcp/.env。
主要能力
搜索
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 工具列表、schema 与注解 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 显式尝试经过身份验证的文章文本，当全文仍不可用时返回非零退出码。仅摘要结果并非全文。
tool 命令还暴露 get_citing_papers、get_referenced_papers、get_search_cache_status 和 clear_search_cache。关系查询接受 DOI/OpenAlex ID，进行有界的一跳检索。缓存默认关闭；启用后会持久化查询和公开结果，需要操作者显式选择。清除搜索缓存不会删除已下载的 PDF。
工作流程
- 使用针对性来源进行搜索以找到论文。
- 以表格呈现结果：标题、作者、年份、来源、DOI/URL。
- 如果用户需要全文，使用 read <source> <paper_id>。
- 如果用户需要 PDF，使用 download <source> <paper_id> 并报告保存路径。
限制
部分来源为可选并依赖环境变量（如 IEEE_API_KEY）。Web of Science 和 Scopus 需要运行时 API 密钥且必须显式选择。Sci-Hub 回退需通过 --use-scihub 选择性启用。缓存默认关闭，启用需操作者显式选择。