PubMed MCP Server

中文 | English

中文

PubMed 文献检索 MCP 服务器，基于 Model Context Protocol 构建，让 AI Agent 直接搜索和阅读 PubMed 学术文献。

无需 NCBI API Key，直接爬取 PubMed 公开网页接口。

使用方式

将本仓库 Git 地址发送给你的 Agent：

https://github.com/wjixiang/pubmed-mcp.git

Agent 会自动克隆、安装依赖、构建并启动 MCP 服务器。

MCP 配置示例

构建完成后，在 Claude Desktop 等 MCP 客户端中配置：

{
  "mcpServers": {
    "pubmed": {
      "command": "node",
      "args": ["/path/to/pubmed-mcp/dist/mcp/index.js"]
    }
  }
}

能力

Tools（Agent 可调用的工具）

| 工具 | 说明 | |---|---| | pubmed_search | 按关键词搜索 PubMed，支持日期范围、文章类型过滤、排序、分页 | | pubmed_article_detail | 按 PMID 获取完整文章记录（作者、摘要、MeSH、参考文献等） |

Resources（可读取的数据资源）

| URI 模板 | 说明 | |---|---| | pubmed://article/{pmid} | 以文本形式提供文章详情 |

Prompts（预设提示模板）

| 名称 | 说明 | |---|---| | literature_review | 引导 Agent 对指定主题进行结构化文献综述 | | article_summary | 引导 Agent 总结指定文章 |

开发

pnpm install
pnpm build          # 构建库 + MCP 服务器
pnpm start:mcp      # 启动 MCP 服务器
pnpm type-check     # TypeScript 类型检查
pnpm test:run       # 运行全部测试
pnpm test:e2e        # E2E 测试（需要网络，访问真实 PubMed）

English

An MCP server for PubMed literature retrieval, built on Model Context Protocol. Enables AI Agents to directly search and read PubMed academic literature.

No NCBI API Key required — scrapes the public PubMed web interface directly.

Usage

Send this repository's Git URL to your Agent:

https://github.com/wjixiang/pubmed-mcp.git

The Agent will automatically clone, install dependencies, build, and launch the MCP server.

MCP Configuration Example

After building, configure in Claude Desktop or other MCP clients:

{
  "mcpServers": {
    "pubmed": {
      "command": "node",
      "args": ["/path/to/pubmed-mcp/dist/mcp/index.js"]
    }
  }
}

Capabilities

Tools (callable by Agent)

| Tool | Description | |---|---| | pubmed_search | Search PubMed by keyword, with date range filters, publication type filters, sorting, and pagination | | pubmed_article_detail | Fetch full article record by PMID — authors, abstract, MeSH terms, references, and more |

Resources (readable data)

| URI Template | Description | |---|---| | pubmed://article/{pmid} | Article details as plain text |

Prompts (pre-built templates)

| Name | Description | |---|---| | literature_review | Guide the Agent to conduct a structured literature review on a given topic | | article_summary | Guide the Agent to summarize a specific article |

Development

pnpm install
pnpm build          # Build library + MCP server
pnpm start:mcp      # Start MCP server
pnpm type-check     # TypeScript type checking
pnpm test:run       # Run all tests
pnpm test:e2e        # E2E tests (requires network, hits live PubMed)

License

MIT