官方

化学文献研究组合

搭建面向药物与生物化学的可追溯文献流程：检索 PubMed、获取论文记录，仅依据真实返回内容总结并保留标识与引用。

难度: 中等费用: 免费与付费混合隐私: 云端 ~30 分钟

开始安装

关注

公开链接：https://chemaiatlas.com/zh/recipes/chemistry-literature-research/

你将能够

使用明确检索式与时间范围检索生物医学相关化学文献。
获取论文依据并保留 PMID/DOI 来源。

你将构建什么

范围与前提

使用 Claude Desktop、Node.js >=24 和 @cyanheads/pubmed-mcp-server 2.10.20。本地 MCP 访问外部文献数据库，对话由云端处理。基线检索 PubMed 记录与摘要，无需 NCBI API Key；可选 Key 可提高允许请求频率，部分全文服务可能要求联系邮箱，这些信息只放在私有配置中。

覆盖与依据

PubMed 主要覆盖生物医学研究，不能代表一般化学、专利或所有出版物的完整索引。摘要不是全文。结果、全文可用性及更正记录会变化，保留检索式、日期、标识及真实取得的依据，不绕过订阅访问限制。

文献检索工具

PubMed MCP (cyanheads)

组合组件

PubMed MCP (cyanheads)

文献检索工具 · 2.10.20

固定已发布 npm 包，主要覆盖生物医学文献。

费用与许可请核对上游及客户端、服务账号条款。

查看资源

兼容环境

客户端	操作系统	架构	版本要求
Claude Desktop	macOS	不限	见组件版本要求
Claude Desktop	Windows	不限	见组件版本要求

安装与测试

1. 准备 Node.js 与 Claude Desktop

全部平台

安装包含 npm 的 Node.js 24 或更新版本及 Claude Desktop，确认允许本地 MCP，且可通过 HTTPS 访问目标数据库。此 Node 方案不需要 Bun。

node --version
npm --version

官方来源

预期结果

Node 显示 v24 或更新版本，npm 可用。

2. 在独立目录安装固定 MCP 包

全部平台

在新的可写工作目录执行，将服务器安装到 .mcp-packages，保留 lockfile 用于记录实际依赖。上游 npx 入口与本地 dist/index.js 入口使用同一个发布包。

npm install --prefix .mcp-packages @cyanheads/[email protected]
npm ls --prefix .mcp-packages --depth=0

官方来源

预期结果

安装清单中显示要求的精确包版本。

3. 配置 macOS 的 Claude Desktop

macOS

打开 Settings > Developer > Edit Config，将条目合并到 mcpServers，替换所有占位绝对路径，包括 node 可执行文件，保留已有服务器。基线查询无需 API Key，可选密钥或邮箱只写入私有配置。

{
  "mcpServers": {
    "pubmed-mcp-server": {
      "command": "/ABSOLUTE/PATH/TO/node",
      "args": [
        "/ABSOLUTE/PATH/.mcp-packages/node_modules/@cyanheads/pubmed-mcp-server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

官方来源

预期结果

有效 JSON 使用 Node 24+ 可执行文件以 stdio 启动已安装包。

4. 配置 Windows 的 Claude Desktop

Windows

{
  "mcpServers": {
    "pubmed-mcp-server": {
      "command": "C:\\ABSOLUTE\\PATH\\TO\\node.exe",
      "args": [
        "C:\\ABSOLUTE\\PATH\\.mcp-packages\\node_modules\\@cyanheads\\pubmed-mcp-server\\dist\\index.js"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

官方来源

预期结果

有效 JSON 使用 Node 24+ 可执行文件以 stdio 启动已安装包。

5. 重启并核对工具

全部平台

完全退出并重启 Claude Desktop，查看 Developer 状态和连接器列表。需包含工具：pubmed_search_articles, pubmed_fetch_articles。

官方来源

预期结果

连接成功，所列工具可用。

6. 检索并核对引用

全部平台

在新对话执行，将每条引用与获取的原始记录对照。

使用 pubmed_search_articles，检索式为 ("machine learning"[Title/Abstract]) AND ("drug discovery"[Title/Abstract]) AND ("2020/01/01"[Date - Publication] : "2025/12/31"[Date - Publication])，最多返回 5 条；再通过 pubmed_fetch_articles 获取真实返回的 PMID。逐条列出标题、年份、PMID、实际存在的 DOI、来源链接和依据摘要的两句话总结。区分摘要与全文可用性，明确缺失摘要及撤稿/更正通知，不用模型记忆补齐；保留实际检索式与日期。

官方来源

预期结果

最多五条真实记录，各 PMID 对应 https://pubmed.ncbi.nlm.nih.gov/<PMID>/；只列出真实返回的 DOI。总结与摘要一致，并说明缺失信息及全文状态。不保证固定篇数或特定论文，零结果应记录检索调整，不编造引用。

7. 检查空检索请求

全部平台

单独要求执行空检索式。

使用空 query 调用 pubmed_search_articles，报告校验错误，不替换成编造引用。

官方来源

预期结果

空请求被明确拒绝。

故障排除

启动失败：检查 Node 24+、node 与模块绝对路径、JSON 语法和本地安装 lockfile。
工具缺失：完全重启客户端并查看 Developer 日志。
HTTP 429 或超时：减少请求、使用分页和退避重试，保留已成功的部分结果。
数据库字段缺失：标为不可用，不推测填充。
零结果：检查实际检索式，减少过严筛选或扩展术语，记录改动。
无全文：只依据摘要总结并链接出版社；有 DOI 不代表能获取全文。
引用不一致：弃用生成引用，从 PMID 原记录重新构建。
撤稿或更正：将关联通知纳入依据判断。

仍无法运行

替代方案

可在 PubMed 网站执行相同检索式。一般化学超出其覆盖时，另行查询相关出版社索引或 Crossref，记录新增来源。