快速结论
cyanheads/pubmed-mcp-server 2.9.8 是非官方、Apache-2.0 许可的生物医学文献 MCP 服务器。它通过 10 个工具连接 PubMed、PubMed Central、Europe PMC、Unpaywall 和相关 NCBI 服务,覆盖检索、元数据获取、全文尝试、相似与引用文献、拼写检查、MeSH、引文格式以及 DOI/PMID/PMCID 转换。项目支持 stdio 和 Streamable HTTP,可用 Bun 运行,也提供面向 Node.js 24 的 npm 路径与容器部署。
它适合给研究助手增加结构化文献检索,不是医学判断系统。摘要、索引、预印本、专利、开放获取全文和解析后的 PDF 文本证据等级不同;任何药物、诊断或治疗结论都必须由合格人员回到原文、研究设计和临床指南核验。项目公开的托管端点由社区维护,并非 NCBI 官方服务。处理未公开查询、患者信息或机构密钥时,应优先本地部署,并把论文正文视为不可信输入以防提示注入。
核心功能
- 10 个文献工具:包括 PubMed 搜索、Europe PMC 搜索、文章获取、全文获取、相关文献、拼写检查、MeSH、引文匹配、格式化和 ID 转换。
- PubMed 精确检索:支持布尔语法、字段标签、日期、出版类型、物种、语言和开放全文等过滤条件。
- Europe PMC 补充来源:可查预印本、专利、Agricola 与仅在 Europe PMC 出现的记录,并使用游标分页。
- 全文回退链:依次尝试 NCBI PMC、Europe PMC JATS XML 和配置后的 Unpaywall 开放获取位置。
- 研究辅助信息:可获取作者、摘要、期刊、MeSH、资助信息,以及相似、被引和参考文献关系。
- 部署选择:支持本地 stdio、Streamable HTTP、Bun、Node.js 24/npm 与 Docker;NCBI API Key 可选。
- 结构化失败:全文不可用、解析失败和服务错误可以返回细分原因,便于客户端解释而不是编造内容。
适合人群
- 需要在 AI 客户端内检索生物医学论文、整理候选文献和规范化标识符的研究人员。
- 想构建文献监测、引文导出或研究计划原型,并能保留人工复核的开发团队。
- 需要把 PubMed 与 Europe PMC 结果放进同一工作流的图书馆员、教师和学生。
- 能配置最小权限、日志脱敏、请求限流和来源展示的 MCP 使用者。
- 不适合用来自动诊断、生成不经审核的临床建议、绕过付费墙、处理可识别患者数据,或把模型摘要当作系统综述结论的场景。
使用场景
典型流程是先把研究问题拆为主题词、MeSH 与日期限制,调用搜索工具得到候选 PMID,再批量获取摘要和出版类型。研究者可以据此筛选需要阅读全文的记录,并导出 BibTeX、RIS、APA、MLA 或 Vancouver 引文。相关文献工具适合扩展已知论文的引用网络,但排序和“相似”只用于发现,不代表研究质量或因果证据。
全文工具应该被理解为“合法开放副本的尽力查找”。PMC 与 Europe PMC 的 JATS 通常结构更清楚;Unpaywall 回退可能取得 HTML 或 PDF,再由解析器转换为 Markdown 或文本。表格、公式、脚注、双栏顺序和补充材料可能丢失。客户端应保留 DOI、PMID、PMCID、来源、可用性原因和原文链接,并允许用户核对。不要把解析失败自动解释为“论文没有提到”。
价格与版本
2.9.8 源码和 npm 包按 Apache-2.0 免费提供,没有项目订阅费。NCBI API Key 是可选项:没有 Key 时可按较低速率使用,配置 Key 通常用于提高 NCBI 请求上限。服务器还会产生计算、存储、日志、容器、反向代理和维护成本;Unpaywall 回退需要按其要求配置联系邮箱,并遵守各上游的礼貌请求和限流规则。
Apache-2.0 覆盖服务器代码,不授予论文全文、图表、补充材料或数据库记录的再发布权。开放获取也不是单一许可证:每篇文章可能采用不同 Creative Commons 条款,或只允许在特定仓库阅读。引文元数据、摘要与全文的权利边界不同。下载、缓存、生成向量、再分发或用于训练前,应按具体来源和文章许可证判断。
国内访问与使用体验
本站将 needsVPN 标为 true,因为 GitHub、npm、公开托管端点以及 NCBI、Europe PMC、Unpaywall 等上游在目标网络中的可达性可能不同。公开端点 https://pubmed.caseyjhand.com/mcp 不是 NCBI 域名,也不是 NCBI 官方托管;试用方便不等于有可用性、隐私或保留期限承诺。生产环境应测试所有上游,并优先把 stdio 服务放在受控设备或内网。
运行条件需按安装方式确认:项目支持 Bun,也可通过 npm 在 Node.js 24 环境运行。NCBI Key、管理员邮箱和 Unpaywall 邮箱应放在秘密管理或环境变量中,不应写进提示词。使用 HTTP 模式时要开启身份验证、TLS、限流和请求隔离。论文标题、摘要、正文与网页是外部输入,可能包含“忽略此前指令”等提示注入文本;工具输出必须作为数据引用,不能获得执行命令或访问其他秘密的权限。
优点
- 10 个工具覆盖从查询、全文到引文和标识符转换的常见研究链路。
- 同时接入 PubMed 与 Europe PMC,可发现预印本和额外开放记录。
- 全文回退链返回来源与失败原因,比无提示地返回空内容更利于审计。
- 支持 stdio 与 Streamable HTTP,便于个人客户端和受控服务部署。
- NCBI API Key 可选,先试用再按合法额度扩展较方便。
- Apache-2.0 代码可审查,且提供 Bun、Node.js 24/npm 和容器路径。
- MeSH、引文格式与 ID 转换减少多个辅助工具之间的切换。
不足
- 社区项目不是 NCBI、NLM、Europe PMC 或医疗机构的官方产品。
- 公开托管端点缺少官方 SLA,不适合默认发送机密研究问题或患者数据。
- 全文受开放获取状态和文章许可证限制,工具不能合法绕过付费墙。
- HTML/PDF 解析可能破坏表格、公式、章节、脚注与阅读顺序。
- 预印本、专利、摘要和正式同行评审论文不能按同等证据等级汇总。
- 文献正文可能包含提示注入,Agent 不应根据文章文本调用高权限工具。
- 医学回答仍可能遗漏否定结果、研究局限、更新指南或人群差异。
- 多个上游各有速率、可用性和数据规则,需要持续监控。
替代品对比
| 工具 | 更适合谁 | 主要优势 | 需要注意 |
|---|---|---|---|
| arXiv MCP Server(cyanheads) | 需要计算机等预印本文献的人 | 同一维护者与相近 MCP 结构 | arXiv 不是生物医学临床索引替代品 |
| ArXiv MCP Server by blazickjp | 需要简洁 arXiv 工作流的人 | 预印本搜索与获取直接 | 缺少 PubMed、MeSH 与医学全文链 |
| ArXiv Scout MCP | 想监测新论文主题的人 | 发现和跟踪流程明确 | 证据范围不同,需另做质量审查 |
| Brave Search | 需要查指南、机构网页和新闻的人 | 通用网页覆盖广 | 不是可复现的生物医学数据库查询 |
| mcp-use | 想自行连接其他学术 API 的开发者 | 通用 MCP 开发与编排 | 不内置 PubMed 语义和工具 |
常见问题 FAQ
这是 NCBI 官方 MCP Server 吗?
不是。它由 cyanheads 社区维护,通过 NCBI 等公开接口取数。公开 hosted 地址也不是 NCBI 官方域名,医学与研究决策应回到原始数据库和论文核验。
必须配置 NCBI API Key 吗?
不必须。无 Key 可以按较低请求速率使用;Key 可提高允许速率。无论是否配置,都要遵守 NCBI 使用政策,并限制并发、重试和批量请求。
它能获取所有论文全文吗?
不能。全文链只尝试 PMC、Europe PMC 和通过 Unpaywall 找到的合法开放副本。没有开放全文、解析失败或服务不可用时会返回原因,不能绕过出版社访问控制。
生成的引文一定完全正确吗?
不一定。格式化依赖上游元数据,作者、页码、在线发表日期和期刊信息可能缺失或变化。正式投稿前应按期刊要求和原文页面复核。
可以用它提供医疗建议吗?
不应直接这样做。它是文献检索工具,不评估患者、不替代临床指南,也不能自动判断偏倚和证据质量。涉及诊断、治疗或药物的问题必须由合格专业人员审核。
如何降低论文中的提示注入风险?
把标题、摘要、正文和网页全部视为不可信数据,使用只读、低权限工具处理;隔离系统指令,不允许文献文本触发命令、网络写入或秘密访问,并在最终答案中保留可核验引用。
总结
cyanheads PubMed MCP Server 2.9.8 将 PubMed、Europe PMC、全文回退、MeSH、相关文献和引文工具组织成了一套实用的 MCP 接口。对研究检索与文献整理,它比通用网页搜索更结构化;但它仍是非官方中间层,公开端点、解析后的全文和模型生成摘要都不能替代原始来源。
建议从本地 stdio 与无敏感数据的检索开始,固定版本并保存完整查询、过滤条件、PMID/DOI、来源和时间戳。随后验证全文解析、引文格式、限流和失败路径,再决定是否配置 Key 或部署 HTTP。医疗内容必须保留专家审核,文章许可必须逐篇核对,任何外部文本都只能作为低权限数据处理。