企业官网建设流程全解析

Paper Search MCP API密钥配置指南：免费Key解锁Semantic Scholar、CORE与Unpaywall稳定访问

【免费下载链接】paper-search-mcpMCP, CLI, Skills for searching and downloading academic papers from multiple sources like arXiv, PubMed, bioRxiv, etc.项目地址: https://gitcode.com/gh_mirrors/pa/paper-search-mcp

Paper Search MCP 是一个支持 arXiv、PubMed、Semantic Scholar 等 20+ 学术源的论文检索与下载工具（MCP 服务器 + CLI + Claude Code Skill 三合一）。本文是一份面向新手的 Paper Search MCP API 密钥配置指南，只需 3 分钟即可配置好 3 个免费 Key，显著提升 Semantic Scholar、CORE 与 Unpaywall 的访问稳定性和限速额度。

为什么需要配置 API Key？

Paper Search MCP 遵循Free-First（免费优先）设计哲学：绝大多数来源（arXiv、PubMed、Crossref、OpenAlex 等）开箱即用，完全不需要任何密钥。API Key 只用于一个目的——在免费匿名访问受限时，提升稳定性和速率上限。

具体到本文关注的三个来源：

可以看到：全部免费，零成本。Unpaywall 甚至不需要申请 Key，填一个有效邮箱即可。

一键配置步骤（推荐 .env 文件）

Paper Search MCP 启动时会自动加载用户级配置文件，无需修改任何 MCP 配置。只需两步：

# 1. 创建配置目录 mkdir -p ~/.config/paper-search-mcp # 2. 写入你的密钥 cat > ~/.config/paper-search-mcp/.env <<'EOF' PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=your@email.com PAPER_SEARCH_MCP_CORE_API_KEY=你的CORE免费Key PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY=你的SemanticScholar免费Key EOF

这个加载逻辑实现在 config.py 中：程序依次查找PAPER_SEARCH_MCP_ENV_FILE指定的路径，或默认的~/.config/paper-search-mcp/.env，并自动忽略注释行、兼容export前缀和引号包裹的值。

💡 变量也支持不带PAPER_SEARCH_MCP_前缀的旧写法（如CORE_API_KEY、UNPAYWALL_EMAIL），向后兼容。

备选方式：Shell 环境变量

如果你习惯用 shell，也可以直接export同名变量（例如在~/.bashrc中追加），优先级上已有环境变量的值不会被 .env 文件覆盖。

备选方式：Claude Desktop 配置中的 env 字段

如果你通过 Claude Desktop 等 MCP 客户端使用，也可以把密钥写在客户端配置的env对象里（PAPER_SEARCH_MCP_UNPAYWALL_EMAIL、PAPER_SEARCH_MCP_CORE_API_KEY等），效果完全一致。三种方式任选其一即可，.env文件最省心。

三个 Key 分别从哪里获取？

📧Unpaywall（只需邮箱）在 Unpaywall 官网的 API 产品页登记一个有效邮箱即可，把邮箱填入PAPER_SEARCH_MCP_UNPAYWALL_EMAIL。这是三个来源中唯一的"硬性要求"——不配置时，Unpaywall 连接器会直接跳过搜索并给出明确提示（见 unpaywall.py）。它基于 DOI 查找论文的开放获取（OA）全文链接，是download_with_fallback回退链路的关键一环。

🔑CORE（免费注册）在 CORE 学术库（core.ac.uk）的 API 服务页免费申请 Key，填入PAPER_SEARCH_MCP_CORE_API_KEY。连接器内置了指数退避重试，遇到 401/403 会自动降级为无 Key 模式继续工作（见 core.py），所以 Key 填错也不会让服务中断。

🔑Semantic Scholar（免费申请）在 Semantic Scholar 平台的 API 产品页免费申请 Key，填入PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY。无 Key 时它也能用，只是匿名限速较低；若 Key 被服务端拒绝（403），连接器会自动改用无 Key 方式重试，保证功能可用（见 semantic.py）。

🎁 顺手加两个免费的：PAPER_SEARCH_MCP_OPENALEX_API_KEY（OpenAlex，免费 Key 可将每日匿名额度提升 10 倍）和PAPER_SEARCH_MCP_DOAJ_API_KEY（DOAJ，提升每小时限速），写入同一个 .env 文件即可。

验证配置是否生效

配置完成后，最直观的验证方式是启动服务后发起一次检索：

• MCP 客户端：直接让 AI"搜索 Semantic Scholar 上关于 transformer 的论文"，若返回结果且不再出现 429 限速提示，说明 Key 生效。
• CLI：运行paper-search search "transformer" -s semantic,core,unpaywall，能正常返回 JSON 即配置成功。

若看到 "missing PAPER_SEARCH_MCP_UNPAYWALL_EMAIL" 之类的提示，检查 .env 路径是否正确，或用export PAPER_SEARCH_MCP_ENV_FILE=/绝对路径/.env指定自定义位置。

常见问题排查

小结

• 3 个免费 Key（其实 Unpaywall 只需一个邮箱）就能让 Paper Search MCP 的核心来源稳定满速运行
• 推荐统一写入~/.config/paper-search-mcp/.env，程序自动加载，无需改动 MCP 配置
• 所有密钥均为可选增强：不配置时，arXiv、PubMed、Crossref 等免费公开源依然照常工作

配置一次，长期受用——现在就动手，让 AI 帮你畅搜学术文献吧！🚀

【免费下载链接】paper-search-mcpMCP, CLI, Skills for searching and downloading academic papers from multiple sources like arXiv, PubMed, bioRxiv, etc.项目地址: https://gitcode.com/gh_mirrors/pa/paper-search-mcp