Paper Search MCP

论文搜索MCP

用于从多个来源搜索和下载学术论文的模型上下文协议（MCP）服务器。该项目遵循自由优先的策略：优先考虑开放和公共数据源，在提高稳定性或覆盖率时支持可选的API密钥，并为高级用户保持源特定连接器的可扩展性。

](https://smithery.ai/server/@openags/paper-search-mcp)

______________________________________________________________________

目录

• 概述
• 项目原则
• 特性
• 来源策略
• Sci-Hub公告
• 安装

- 克劳德代码（技能） - 方法1--Smithery - 方法2--uvx - 方法3--uv - 方法4-pip - 方法5--npx - - 方法7——从源代码克隆并运行 - 环境变量

• 贡献
• 演示
• 明星历史
• 许可证
• 待办事项

______________________________________________________________________

概述

paper-search-mcp 是一个基于Python的工具，用于从各种平台搜索和下载学术论文。它提供了搜索论文、下载PDF和提取文本的工具，使其成为研究人员和人工智能驱动的工作流程的理想选择。它可以用作MCP服务器（用于Claude Desktop和其他MCP客户端），也可以用作具有CLI界面的Claude代码技能。

项目原则

• 免费优先：公共和开源是默认的路线图。付费或受限来源不是该项目的核心方向。
• 可选API密钥：只有当API密钥提高了稳定性、速率限制或元数据质量时，才支持它们。只要有可能，MCP在没有它们的情况下仍然可以使用。
• LLM友好检索：搜索结果应标准化、重复数据消除，并尽可能完整地用于下游LLM工作流程。
• 来源透明度：不同的来源有不同的优势。MCP应该明确这些权衡，而不是假装每个源都支持全文检索。

______________________________________________________________________

特性

• 两层架构:

- 第1层（统一工具）：高级 search_papers 用于多源并发搜索和重复数据删除，以及 download_with_fallback 依赖于出版商的开放访问链接，并有连续的回退。 - 第2层（平台连接器）：用于特定学术平台（arXiv、PubMed、bioRxiv、Semantic Scholar等）的模块化连接器，配备通过regex文本分析或API字段进行智能DOI提取。

• 多源支持：从arXiv、PubMed、bioRxiv、medRxiv、Google Scholar、IACR ePrint Archive、Semantic Scholar、Crossref、OpenAlex、PubMed-Central（PMC）、CORE、Europe PMC、dblp、OpenAIRE、CiteSeerX、DOAJ、BASE、Zenodo、HAL、SSRN、Unpaywall（DOI查找）和可选的Sci-Hub工作流中搜索和下载论文。
• 标准化输出：论文将通过以下方式以一致的词典格式返回 Paper 类。
• 免费第一设计：在任何可选的商业或受限集成之前，优先考虑开放和公共资源。
• 可选的API-Key增强功能：像Semantic Scholar这样的来源可以更好地使用用户提供的API密钥，但并不旨在强制付费使用。
• 发现+检索工作流程：Google Scholar和Crossref可用于发现和DOI回填，而开放存储库和发布者链接可用于合法的全文解析（如有）。
• OA第一后备链: download_with_fallback 现在遵循源代码本地下载→ OpenAIRE/CORE/欧洲PMC/PMC发现→ 未付DOI决议→ 可选Sci-Hub。
• MCP集成：与MCP客户端兼容，用于LLM上下文增强。
• 可扩展设计：通过扩展，轻松添加新的学术平台 academic_platforms 模块。

来源策略

长期目标不是依赖于一个搜索引擎，而是将多个免费和公共资源与明确的角色结合起来：

• 开放元数据主干：Crossref、OpenAlex、语义学者、dblp、CiteSeerX、SSRN、Unpaywall（以DOI为中心的OA元数据）。
• 特定学科来源：arXiv，PubMed，PubMedCentral，欧洲PMC，IACR。
• 开放获取全文源：arXiv、PMC、CORE、OpenAIRE、DOAJ、BASE、Zenodo、HAL、出版商开放获取链接。
• 发现和DOI恢复：当其他公共元数据源不完整时，Google Scholar可用于查找标题、版本和DOI线索。

推荐免费第一路线图：

1. 保持当前公共资源的稳定。
2. 添加OpenAlex作为广泛的免费元数据源。
3. 添加PubMed Central和Europe PMC，以增强生物医学全文访问。
4. 添加CORE和OpenAIRE用于基于存储库的开放访问检索。
5. 主要将Google Scholar用作发现回退，而不是主要的规范来源。

平台能力矩阵

该矩阵反映 已验证的实时集成结果 来自此存储库中的功能和端到端回归测试。列显示了在正常条件下观察到的最高能力水平。

✅ = 在现场测试中可靠。 ⚠️ = 工作，但受到上游不稳定或访问限制。 ❌ = 不支持。 🔑 = 需要钥匙。 🚧 = 只有骨架。

______________________________________________________________________

凭证和API关键要求

所有钥匙都是 可选的 除非特别注明。在中配置它们 .env （首选）或作为外壳出口。

所有变量都遵循 PAPER_SEARCH_MCP_ 前缀方案。没有前缀的旧名称（例如。 CORE_API_KEY, UNPAYWALL_EMAIL)仍然支持向后兼容性。

______________________________________________________________________

已知上游限制

一些搜索失败是由外部提供程序不稳定引起的，而不是由此项目中的错误引起的：

可选付费平台连接器（第3阶段）

IEEE Xplore和ACM数字图书馆连接器包括在内 选择加入骨架. 他们是 默认禁用 -除非显式配置相应的密钥，否则不会进行API调用。

如何启用：

export PAPER_SEARCH_MCP_IEEE_API_KEY=       # free key at https://developer.ieee.org/
export PAPER_SEARCH_MCP_ACM_API_KEY=         # see https://libraries.acm.org/digital-library

一旦设置了密钥，相应的源将自动添加到 ALL_SOURCES 及其MCP工具(search_ieee / search_acm, download_ieee / download_acm, read_ieee_paper / read_acm_paper)在服务器启动时注册。

如果没有密钥，连接器只会记录启动警告，服务器的其他部分不受影响。

免费源代码扩展（第4阶段）

MCP服务器现在集成了三个额外的免费源代码连接器：

• zenodo：官方Zenodo REST API连接器（搜索+记录依赖PDF/read支持）。
• hal：HAL公共API连接器（搜索+记录依赖PDF/读取支持）。
• ssrn：发现优先的连接器，带有硬化的解析器，并在有直接的公共PDF链接时尽最大努力下载/阅读。
• unpaywall：以DOI为中心的OA元数据源，用于独立查找(search_unpaywall)以及回退URL解析。

SSRN集成仍然是合规性第一：它只尝试SSRN页面公开的直接公共PDF链接。如果需要登录/限制传递，连接器将返回一条明确的消息，而不是绕过访问控制。

Sci-Hub公告

Sci-Hub支持可以作为可选连接器提供给明确选择启用它的用户，但不应将其视为默认或推荐的全文路径。

• 可用性不稳定，镜像经常更改。
• 法律和政策风险因管辖区而异。
• README和工具说明应明确说明用户有责任启用和使用它。
• 应尽可能首先尝试开放获取和出版商许可的来源。

______________________________________________________________________

安装

选择最适合您工作流程的方法。所有方法都支持相同的 可选API密钥.

______________________________________________________________________

Claude Code（技能）——推荐给Claude Code用户

作为Claude Code技能而不是MCP服务器进行安装。当你提到查找论文、学术文献等时，克劳德可以自动访问论文搜索。--不需要MCP配置。

先决条件: 紫外线 和 克劳德代码.

步骤1——克隆仓库：

git clone https://github.com/openags/paper-search-mcp.git ~/paper-search-mcp

第二步——安装技能：

mkdir -p ~/.claude/skills/paper-search
cp ~/paper-search-mcp/claude-code/SKILL.md ~/.claude/skills/paper-search/SKILL.md

步骤3——更新技能中的repo路径：

编辑 ~/.claude/skills/paper-search/SKILL.md 并替换所有 ` 带有克隆的绝对路径（例如。 /Users/yourname/paper-search-mcp`).

步骤4（可选）-配置API密钥：

创建一个 .env repo根目录中的文件，以获取可选的API密钥（请参阅 环境变量).

就这样 下次你启动Claude Code时，只需让它查找试卷——该技能会自动激活。例如：

• “查找我最近关于CRISPR碱基编辑的论文”
• “在arxiv和语义学者中搜索变换器注意机制”
• “下载arxiv论文的PDF 2106.12345”

该技能使用CLI(paper-search)它封装了与MCP服务器相同的库，输出JSON用于搜索/下载，输出纯文本用于读取。

______________________________________________________________________

MCP服务器配置文件位置 （以下方法） - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

______________________________________________________________________

方法1--Smithery（一个命令，建议用于Claude Desktop）

npx -y @smithery/cli install @openags/paper-search-mcp --client claude

Smithery会自动为您写入正确的配置块。无需手动编辑JSON。

______________________________________________________________________

方法2-- uvx （无需安装，始终为最新版本）

uvx 直接从PyPI运行该包，无需永久安装。需要 紫外线.

# Install uv (skip if already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

⚠️ macOS笔记: uvx 生成的包装脚本依赖于 realpath，默认情况下不包含在macOS中。如果你看到a realpath: command not found 错误，要么安装GNU coreutils(brew install coreutils)或使用 方法3(uv run) 相反，它没有这个限制。

Claude桌面配置：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "uvx",
      "args": ["paper-search-mcp"],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": "",
        "PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN": "",
        "PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL": "",
        "PAPER_SEARCH_MCP_IEEE_API_KEY": "",
        "PAPER_SEARCH_MCP_ACM_API_KEY": ""
      }
    }
  }
}

______________________________________________________________________

方法3-- uv （持续安装）

uv tool install paper-search-mcp

Claude桌面配置：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "uv",
      "args": ["tool", "run", "paper-search-mcp"],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": "",
        "PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN": "",
        "PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL": "",
        "PAPER_SEARCH_MCP_IEEE_API_KEY": "",
        "PAPER_SEARCH_MCP_ACM_API_KEY": ""
      }
    }
  }
}

______________________________________________________________________

方法4-- pip （标准Python安装）

pip install paper-search-mcp

Claude桌面配置：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "python",
      "args": ["-m", "paper_search_mcp.server"],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": "",
        "PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN": "",
        "PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL": "",
        "PAPER_SEARCH_MCP_IEEE_API_KEY": "",
        "PAPER_SEARCH_MCP_ACM_API_KEY": ""
      }
    }
  }
}

如果 python 不在PATH中，请将其替换为完整路径（例如。 /usr/bin/python3 或 C:\Python311\python.exe).跑 which python3 / where python 找到它。

______________________________________________________________________

方法5-- npx （通过Smithery CLI，不需要本地Python）

npx -y @smithery/cli run @openags/paper-search-mcp

Claude桌面配置：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "@openags/paper-search-mcp"],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": ""
      }
    }
  }
}

______________________________________________________________________

方法6-Docker

docker build -t paper-search-mcp .
docker run --rm -i \
  -e PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=your@email.com \
  -e PAPER_SEARCH_MCP_CORE_API_KEY=your_core_key \
  paper-search-mcp

Claude桌面配置：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "paper-search-mcp"],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": "",
        "PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN": "",
        "PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL": "",
        "PAPER_SEARCH_MCP_IEEE_API_KEY": "",
        "PAPER_SEARCH_MCP_ACM_API_KEY": ""
      }
    }
  }
}

______________________________________________________________________

方法7——从源代码克隆并运行（开发/建议用于macOS本地）

这是macOS上最可靠的方法——没有包装脚本，没有 realpath 问题。

# 1. Install uv (skip if already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Clone repo
git clone https://github.com/openags/paper-search-mcp.git
cd paper-search-mcp

# 3. Verify it runs (uv auto-resolves dependencies, no manual install needed)
uv run -m paper_search_mcp.server

Claude桌面配置 （将目录路径替换为实际的克隆位置）：

{
  "mcpServers": {
    "paper-search-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/paper-search-mcp",
        "-m", "paper_search_mcp.server"
      ],
      "env": {
        "PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com",
        "PAPER_SEARCH_MCP_CORE_API_KEY": "",
        "PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY": "",
        "PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN": "",
        "PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL": "",
        "PAPER_SEARCH_MCP_IEEE_API_KEY": "",
        "PAPER_SEARCH_MCP_ACM_API_KEY": ""
      }
    }
  }
}

例如，如果您克隆到 /Users/mac/Pengsong/paper-search-mcp:

"args": ["run", "--directory", "/Users/mac/Pengsong/paper-search-mcp", "-m", "paper_search_mcp.server"]

uv run 首次运行时自动将依赖项安装到隔离环境中--否 pip install 或 venv 需要。

对于主动开发，可以选择安装一个可编辑的副本：

uv venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

______________________________________________________________________

环境变量(.env 文件）

您可以将密钥存储在JSON配置中，而不是直接将其放入JSON配置中 .env 项目根目录中的文件（启动时自动加载）：

cp .env.example .env   # if running from source
# or create ~/.paper-search-mcp.env for global use

PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=your@email.com
PAPER_SEARCH_MCP_CORE_API_KEY=
PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY=
PAPER_SEARCH_MCP_ZENODO_ACCESS_TOKEN=
PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL=
PAPER_SEARCH_MCP_IEEE_API_KEY=
PAPER_SEARCH_MCP_ACM_API_KEY=

要使用自定义路径，请执行以下操作： export PAPER_SEARCH_MCP_ENV_FILE=/absolute/path/to/.env

不带 PAPER_SEARCH_MCP_ 前缀（例如。 CORE_API_KEY, UNPAYWALL_EMAIL)仍然支持向后兼容性。

______________________________________________________________________

贡献

我们欢迎捐款！以下是如何开始：

1. 分叉存储库:

在GitHub上点击“分叉”。

1. 克隆和设置:

   git clone https://github.com/yourusername/paper-search-mcp.git
   cd paper-search-mcp
   uv venv && source .venv/bin/activate
   uv pip install -e ".[dev]"

1. 进行更改:

- 在中添加新平台 academic_platforms/. - 更新测试 tests/.

1. 提交拉取请求:

在GitHub上推送更改并创建PR。

______________________________________________________________________

演示

待办事项

规划中的学术平台

• \[√\]arXiv
• \[√\]PubMed
• \[√\]bioRxiv
• \[√\]medRxiv
• \[√\]谷歌学者
• \[√\]IACR电子打印档案
• \[√\]语义学者
• \[√\]交叉引用
• \[√\]PubMed Central（PMC）
• \[√\]核心
• \[√\]欧洲PMC
• \[√\]Sci-Hub警告和启用文档

开发任务

• \[√\]修复异步搜索错误，确保可靠的快速MCP事件
• \[√\]端到端完整流水线测试脚本（搜索、解析、下载）
• \[√\]建立两层联邦架构（第一层工具： search_papers)
• \[√\]确保跨元数据字段和摘要回退进行普遍的DOI提取
• \[\]引文图和论文关系上下文特征
• \[√\]扩展全栈OpenAlex提供商

优先级自由和开源

• \[√\]PubMed Central（PMC）
• \[√\]核心
• \[√\]OpenAlex
• \[√\]欧洲PMC
• \[√\]OpenAIRE
• \[√\]dblp
• \[√\]CiteSeerX
• \[√\] DOAJ
• \[√\]基地
• \[√\]泽诺多
• \[√\]哈尔
• \[√\]SSRN（发现+尽力全文）
• \[√\]Unpaywall（独立DOI搜索源）

可选和非核心集成

• \[\]研究之门
• \[\]JSTOR
• \[\]科学直接
• \[\]施普林格链接
• \[√\]IEEE Xplore（可选骨架——使用激活 IEEE_API_KEY)
• \[√\]ACM数字图书馆（可选骨架——使用激活 ACM_API_KEY)
• \[\]科学网
• 范围

______________________________________________________________________

明星历史


______________________________________________________________________

许可证

该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。

______________________________________________________________________

快乐的研究 paper-search-mcp！如果您遇到问题，请打开GitHub问题。