Paper Search MCP

一个用于搜索和下载学术论文的 MCP 服务器，支持从多个来源（如 arXiv、PubMed、Semantic Scholar 等）检索和获取论文全文。适用于研究人员、AI 工作流和需要文献检索的场景。

设计原则

• 免费优先：公共和开放来源是默认路线图，付费或受限来源不是本项目的核心方向。
• 可选 API Key：API key 仅用于提升稳定性、速率限制或元数据质量，尽可能无 key 也可使用。
• LLM 友好检索：搜索结果应标准化、去重，并尽可能完整，以支持下游 LLM 工作流。
• 来源透明：不同来源有不同优势，本 MCP 应明确这些权衡，而不是假装每个来源都支持全文检索。

适用场景

• 研究人员需要快速查找相关学术论文
• AI 工作流需要自动获取论文元数据和全文
• 需要从多个来源综合检索去重结果
• 需要下载开放获取（OA）论文 PDF

效果预览

核心能力

• 双层架构：提供高层工具（search_papers 多源并发搜索与去重，download_with_fallback 依次尝试开放获取链接）和底层平台连接器。
• 多源支持：支持 arXiv、PubMed、bioRxiv、medRxiv、Google Scholar、IACR、Semantic Scholar、Crossref、OpenAlex、PubMed Central (PMC)、CORE、Europe PMC、dblp、OpenAIRE、CiteSeerX、DOAJ、BASE、Zenodo、HAL、SSRN、Unpaywall 以及可选的 Sci-Hub。
• 标准化输出：所有论文以统一的 Paper 字典格式返回。
• 免费优先设计：优先使用开放和公共数据源，API key 仅用于提升稳定性或覆盖率，不影响基本使用。
• 发现与检索工作流：Google Scholar 和 Crossref 可用于发现和 DOI 补全，开放仓库和出版商链接用于合法全文获取。
• OA 优先降级链：download_with_fallback 按源原生下载 → OpenAIRE/CORE/Europe PMC/PMC 发现 → Unpaywall DOI 解析 → 可选 Sci-Hub 的顺序依次尝试。
• MCP 集成：兼容 MCP 客户端，可为 LLM 提供上下文增强。
• 可扩展设计：可通过 academic_platforms 模块添加新的学术平台。

工作方式

1. 用户提供：搜索查询（关键词、标题、作者等），或论文标识（DOI、arXiv ID）。
2. Skill 处理：并行搜索多个已启用的学术来源，自动去重，提取元数据；对于下载请求，按开放获取优先级依次尝试。
3. 用户获得：结构化的论文列表（标题、作者、摘要、DOI、链接等），可下载 PDF 或读取文本内容。

你需要提供

配置环境变量（可选，但部分来源推荐设置以提升性能）：

环境变量	提供方	是否需要	获取方式
PAPER_SEARCH_MCP_UNPAYWALL_EMAIL	Unpaywall	是（否则 Unpaywall 不可用）	任意有效邮箱，在 unpaywall.org 注册
PAPER_SEARCH_MCP_CORE_API_KEY	CORE	推荐	免费申请于 core.ac.uk/services/api
PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY	Semantic Scholar	可选	免费申请于 semanticscholar.org — 提升速率限制
PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL	Google Scholar	可选	你的 HTTP/HTTPS 代理 URL — 绕过反爬检测
PAPER_SEARCH_MCP_DOAJ_API_KEY	DOAJ	可选	免费申请于 doaj.org — 提升小时速率限制
PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN	Zenodo	可选	免费申请于 zenodo.org — 私有记录需要
PAPER_SEARCH_MCP_IEEE_API_KEY	IEEE Xplore	激活需要	免费申请于 developer.ieee.org
PAPER_SEARCH_MCP_ACM_API_KEY	ACM DL	激活需要	参见 libraries.acm.org/digital-library/acm-open

所有变量使用 PAPER_SEARCH_MCP_ 前缀。旧版无前缀名称（如 CORE_API_KEY）仍向后兼容。

你可以将这些变量存储在 ~/.config/paper-search-mcp/.env 文件中，启动时自动加载。也可通过 PAPER_SEARCH_MCP_ENV_FILE 环境变量指定自定义路径。

你会获得

• 搜索结果：以 JSON 格式返回的论文列表，包含标题、作者、摘要、DOI、来源、链接等。
• 下载的 PDF 文件（当来源支持且提供开放获取链接时）。
• 论文文本内容（通过 read 工具，当来源支持时）。

使用示例

在 Claude Code 中，你可以直接说出需求：

• "Find me recent papers on CRISPR base editing"
• "Search arxiv and semantic scholar for transformer attention mechanisms"
• "Download the PDF for arxiv paper 2106.12345"

平台能力矩阵

下表展示了各平台在搜索、下载和读取方面的实际支持情况（基于集成测试结果）：

平台	搜索	下载	读取	备注
arXiv	✅	✅	✅	开放 API，稳定
PubMed	✅	❌	⚠️ 仅元数据	开放 API，稳定
bioRxiv	✅	✅	✅	开放 API，稳定
medRxiv	✅	✅	✅	开放 API，稳定
Google Scholar	⚠️	❌	❌	反爬检测活跃，需设置 PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL
IACR	✅	✅	✅	开放 API，稳定
Semantic Scholar	✅	✅ (OA)	✅ (OA)	无 key 也可用（速率限制）；有 key 可提升限制；key 被拒绝 (403) 会自动无 key 重试
Crossref	✅	❌	⚠️ 仅元数据	开放 API，稳定
OpenAlex	✅	❌	⚠️ 仅元数据	开放 API，稳定
PMC	✅	✅ (仅OA)	✅ (仅OA)	仅开放获取 PDF；部分代理环境可能阻止直接下载
CORE	✅	✅ (取决于记录)	✅ (取决于记录)	推荐免费 key；连接器重试并在 401/403 时自动降级为无 key
Europe PMC	✅	✅ (OA)	✅ (OA)	仅开放获取 PDF；部分代理环境可能阻止直接下载
dblp	✅	❌	⚠️ 仅元数据	开放 API，稳定
OpenAIRE	✅	❌	❌	开放 API；遇到 403 时重试 3 次，逐步升级请求策略
CiteSeerX	⚠️	✅ (取决于记录)	⚠️	API 端点间歇性不可用 / 重定向到网络存档
DOAJ	✅	⚠️ (取决于URL)	⚠️ (取决于URL)	PDF 可用性因文章而异；免费 key 提升速率限制
BASE	⚠️	✅ (取决于记录)	✅ (取决于记录)	OAI-PMH 端点需要机构 IP 注册；否则优雅返回空结果
Zenodo	✅	✅ (取决于记录)	✅ (取决于记录)	开放 API，稳定
HAL	✅	✅ (取决于记录)	✅ (取决于记录)	开放 API，稳定
SSRN	⚠️	⚠️ 尽力而为	⚠️ 尽力而为	403 反爬检测活跃；仅公共 PDF
Unpaywall	✅ (DOI 查找)	❌	❌	需要 PAPER_SEARCH_MCP_UNPAYWALL_EMAIL
Sci-Hub (可选)	⚠️ 仅降级	✅	❌	可选，镜像不稳定，用户自行承担法律风险
IEEE Xplore 🔑	🚧 骨架	🚧 骨架	🚧 骨架	需要 PAPER_SEARCH_MCP_IEEE_API_KEY 激活
ACM DL 🔑	🚧 骨架	🚧 骨架	🚧 骨架	需要 PAPER_SEARCH_MCP_ACM_API_KEY 激活

✅ = 实际测试可靠。⚠️ = 可用但受上游不稳定或访问限制影响。❌ = 不支持。🔑 = 需要 key。🚧 = 仅骨架。

注意事项

上游限制

部分搜索失败由外部提供方不稳定导致，非本工具 bug：

来源	症状	原因	解决方法
Google Scholar	返回 0 结果 / 空 HTML	反爬检测 (CAPTCHA)	设置 PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL 为代理
Semantic Scholar	429 速率限制	匿名访问限制	设置 PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY；若 key 被拒 (403) 连接器自动无 key 重试
CORE	500 / 超时	未认证速率限制	设置 PAPER_SEARCH_MCP_CORE_API_KEY（免费）；连接器指数退避重试，401/403 时降级为无 key
OpenAIRE	临时 403	基于 IP 的会话速率限制	连接器重试 3 次，逐步升级请求策略
CiteSeerX	404 重定向到网络存档	PSU 端点间歇性重定向	无解决方法；连接器优雅返回空结果
BASE	搜索返回 0 结果	OAI-PMH 端点需要机构 IP 注册	在 base-search.net 注册 API 访问；否则优雅返回空结果
SSRN	HTTP 403	反爬检测 (Cloudflare)	无解决方法；连接器尝试两个端点，失败时返回明确消息
PMC / Europe PMC	PDF 下载 ProxyError	本地代理阻止直接 HTTPS PDF 下载	禁用代理或使用 download_with_fallback
Unpaywall	跳过	UNPAYWALL_EMAIL 环境变量未设置	在 ~/.config/paper-search-mcp/.env 中设置 PAPER_SEARCH_MCP_UNPAYWALL_EMAIL

Sci-Hub 注意事项

• Sci-Hub 支持作为可选连接器，但不应作为默认或推荐的全文获取路径。
• 镜像稳定性差，地址频繁变更。
• 法律和政策风险因司法管辖区而异。
• 用户自行负责启用和使用。
• 应优先尝试开放获取和出版商允许的来源。

可选付费平台连接器

• IEEE Xplore 和 ACM Digital Library 连接器作为 骨架 包含，默认禁用，除非配置相应 API key。
• 设置 key 后，对应来源自动添加到 ALL_SOURCES，并注册 MCP 工具。
• 无 key 时仅记录启动警告，不影响服务器其他功能。