PubMed MCP Server v3.0

为 LLM Agent 提供结构化 PubMed 文献数据的 MCP 服务器。Agent 友好的响应模型，专注数据提供，分析交给 LLM。

LLM Agent <--MCP--> PubMed MCP Server <--API--> PubMed / PMC / Unpaywall

核心能力： 文献搜索 / 智能缓存 / OA 全文下载 / Agentic 响应模型

---

快速开始

前置要求： Node.js v18.0.0+

1. 安装

# npm 全局安装
npm install -g mcp-pubmed-llm-server

# 或从源码构建
git clone git@github.com:PancrePal-xiaoyibao/mcp-pubmed-server-pancrpal.git
cd mcp-pubmed-server-pancrpal
npm install && npm run build

2. 配置

cp .env.example .env

编辑 .env：

PUBMED_API_KEY=你的NCBI_API密钥    # 可选，https://www.ncbi.nlm.nih.gov/account/settings/
PUBMED_EMAIL=你的邮箱               # 可选（建议填写）
ABSTRACT_MODE=quick                 # quick(1500字符) | deep(6000字符)
FULLTEXT_MODE=disabled              # disabled | enabled | auto

说明： API Key 和 Email 均非必填。无 Key 时匿名运行（3 次/秒），有 Key 时 10 次/秒。

3. 运行

# npm 包
mcp-pubmed-llm-server
# 或
npx mcp-pubmed-llm-server

# 源码开发
npm run dev

# 源码生产
npm run build && npm start

---

传输模式

模式	适用场景	启动方式
stdio	本地 MCP 客户端集成	npm start（默认）
Streamable HTTP	服务端远程部署	npm run start:http

stdio 模式（默认）

npm start
# 或
node dist/index.js --mode=stdio

Streamable HTTP 模式

npm run start:http
# 或
node dist/index.js --mode=streamableHttp

Docker 部署：

cd docker
cp .env.example .env   # 编辑填入配置
docker compose up -d --build

验证：

curl http://localhost:8745/health
# {"status":"ok","mode":"streamableHttp","sessions":0}

端点：

• POST /mcp — MCP 协议消息
• GET /mcp — SSE 事件流
• DELETE /mcp — 关闭会话
• GET /health — 健康检查

---

MCP 客户端配置

Claude Desktop / Claude Code / Cline

{
  "mcpServers": {
    "pubmed": {
      "command": "npx",
      "args": ["-y", "mcp-pubmed-llm-server"],
      "env": {
        "PUBMED_API_KEY": "你的API密钥（可选）",
        "PUBMED_EMAIL": "你的邮箱（可选）",
        "ABSTRACT_MODE": "deep",
        "FULLTEXT_MODE": "enabled"
      }
    }
  }
}

配置文件位置：

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Claude Code: ~/.claude/config.json
• Cline: VS Code 设置中的 MCP Servers

Cherry Studio

stdio 模式： 同上配置，type 设为 stdio

streamableHttp 模式： type 设为 streamableHttp，baseUrl 设为 http://<服务器IP>:8745/mcp

---

工具列表（8 个）

文献搜索

工具	说明	关键参数
pubmed_search	文献搜索，支持 Boolean/MeSH	query, max_results, days_back, sort_by, format
pubmed_get_details	获取 PMID 完整信息（单个或批量）	pmids, format
pubmed_extract_info	提取论文关键信息段落	pmid, sections
pubmed_find_related	查找相关/综述文献	pmid, type, max_results

缓存管理

工具	说明	关键参数
pubmed_manage_cache	缓存统计、清理、清空	action, target

全文下载（需 FULLTEXT_MODE=enabled）

工具	说明	关键参数
pubmed_detect_fulltext	检测 OA 状态和全文可用性	pmid, auto_download
pubmed_download_fulltext	下载全文 PDF（单篇或批量）	pmids, force
pubmed_system_status	系统环境和 API Key 状态检测	无

---

Agentic 响应模型

每个工具返回统一的 AgentResponse<T> 结构，为 AI Agent 优化：

{
  "status": "success",
  "data": { ... },
  "metadata": {
    "tool": "pubmed_search",
    "executionMs": 1234,
    "timestamp": "2025-01-01T00:00:00.000Z",
    "pagination": { "total": 500, "returned": 20, "hasMore": true }
  },
  "suggestions": [
    {
      "tool": "pubmed_get_details",
      "reason": "Get full metadata for specific articles of interest.",
 

... [View full README on GitHub](https://github.com/PancrePal-xiaoyibao/mcp-pubmed-server-pancrpal#readme)