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-mcpPaper Search MCP 是一个支持 arXiv、PubMed、Semantic Scholar 等 20 学术源的论文检索与下载工具MCP 服务器 CLI Claude Code Skill 三合一。本文是一份面向新手的 Paper Search MCP API 密钥配置指南只需 3 分钟即可配置好 3 个免费 Key显著提升 Semantic Scholar、CORE 与 Unpaywall 的访问稳定性和限速额度。为什么需要配置 API KeyPaper Search MCP 遵循Free-First免费优先设计哲学绝大多数来源arXiv、PubMed、Crossref、OpenAlex 等开箱即用完全不需要任何密钥。API Key 只用于一个目的——在免费匿名访问受限时提升稳定性和速率上限。具体到本文关注的三个来源来源环境变量是否必须免费吗配置后收益Semantic ScholarPAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY可选✅ 免费解除匿名限速避免 429COREPAPER_SEARCH_MCP_CORE_API_KEY推荐✅ 免费避免未认证的 500/超时UnpaywallPAPER_SEARCH_MCP_UNPAYWALL_EMAIL必须✅ 只需邮箱不配置则该来源被整体跳过可以看到全部免费零成本。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_EMAILyouremail.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_KEYOpenAlex免费 Key 可将每日匿名额度提升 10 倍和PAPER_SEARCH_MCP_DOAJ_API_KEYDOAJ提升每小时限速写入同一个 .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指定自定义位置。常见问题排查症状原因解决办法Semantic Scholar 返回 429匿名限速配置免费 API KeyCORE 返回 500 / 超时未认证限速配置免费 CORE KeyUnpaywall 被完全跳过未设置邮箱填写PAPER_SEARCH_MCP_UNPAYWALL_EMAILOpenAlex 403/429 配额错误匿名每日限额配置免费 OpenAlex Key小结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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考