pmc-pdf-downloader
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pmc-pdf-downloader 批量下载 input.csv 里的所有 PDF 到 D:/papers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PMC PDF 下载器 MCP Server
通过 MCP 协议批量下载 PMC 开放获取 PDF,支持 PoW 验证自动绕过、并行下载、失败重试。
快速开始
1. 安装 uv(一次性)
uv 是单一二进制的 Python 包管理工具,安装命令一行:
# Mac/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"2. 安装 Chromium(一次性)
Playwright 的 chromium 浏览器无法通过 pip 安装,需手动运行一次:
# 方式 A:使用 uvx 直接从 git 仓库运行(推荐,无需克隆)
uvx --from git+https://github.com/oranges7/pmc-pdf-downloader playwright install chromium
# 方式 B:克隆后本地运行
git clone https://github.com/oranges7/pmc-pdf-downloader
cd pmc-pdf-downloader
uv sync
uv run playwright install chromium3. 配置 MCP 客户端
Trae IDE / Claude Desktop
编辑 MCP 配置文件(如 claude_desktop_config.json),加入:
{
"mcpServers": {
"pmc-pdf-downloader": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/oranges7/pmc-pdf-downloader",
"pmc-pdf-downloader"
]
}
}
}Cursor
Settings → MCP → Add New MCP Server:
Type:
stdioCommand:
uvxArgs:
--from git+https://github.com/oranges7/pmc-pdf-downloader pmc-pdf-downloader
本地克隆版(不想推 GitHub 时用)
{
"mcpServers": {
"pmc-pdf-downloader": {
"command": "uv",
"args": [
"run",
"--directory",
"D:/path/to/pmc-pdf-downloader",
"pmc-pdf-downloader"
]
}
}
}4. 使用
配置完成后,LLM 即可调用以下 4 个工具:
工具 | 用途 | 关键参数 |
| 查询 PMID 对应的 PMCID |
|
| 下载单个 PMC PDF |
|
| 批量下载(CSV/TXT 输入) |
|
| 读取下载报告全文 |
|
示例对话:
"帮我查 PMID 42534757 的 PMCID"
"下载 PMC7440785 的 PDF 到 D:/papers"
"批量下载 input.csv 里的所有 PDF 到 D:/papers,CSV 格式"
"看一下 D:/papers 的下载报告"
Related MCP server: Paper Download MCP Server
关于浏览器
默认情况下无需配置浏览器位置。运行 playwright install chromium 后,浏览器会自动安装到用户目录的默认位置,MCP server 启动时自动查找:
Windows:
%USERPROFILE%\AppData\Local\ms-playwright\chromium-XXXXMac/Linux:
~/.cache/ms-playwright/chromium-XXXX
可选环境变量(特殊场景):
环境变量 | 用途 | 示例 |
| 自定义 chromium 安装/查找目录(如系统盘空间不足时) |
|
| 直接指向系统已装的 Chrome/Edge 可执行文件,跳过 chromium 下载 |
|
本地开发
git clone https://github.com/oranges7/pmc-pdf-downloader
cd pmc-pdf-downloader
uv sync # 自动建虚拟环境、装依赖
uv run playwright install chromium # 一次性
uv run pmc-pdf-downloader # 启动 MCP server输入文件格式
CSV 模式
含两列:PMID 和 PMCID:
PMID,PMCID
42534757,PMC7440785
37984867,PMC10787064TXT 模式
每行一个 PMID,server 会自动调 NCBI elink API 查询 PMCID:
42534757
37984867
38133632输出
PDF 文件命名:
<PMID>_<PMCID>.pdf(如42534757_PMC7440785.pdf)已存在文件自动跳过
下载报告:
<output_dir>/download_report.txt,含成功/失败统计与失败原因
Available Tools
4 toolsbatch_download_pdfsA
批量下载 PMC PDF。自动跳过已存在的文件,失败自动重试 1 次。
Args:
input_file: 输入文件路径。CSV 需含 PMID+PMCID 两列;TXT 每行一个 PMID(会自动查询 PMCID)
output_dir: PDF 保存目录的绝对路径
mode: "csv" 或 "txt",默认 "csv"
num_workers: 并行下载线程数,默认 2
Returns:
汇总信息字符串,如 "完成: 成功 2400, 失败 36, 报告: <path>"
Inputs: input_file (required), output_dir (required), mode, num_workers. Returns: result
download_single_pdfA
下载单个 PMC 文章的 PDF。已存在文件会自动跳过。
Args:
pmcid: PMCID(如 "PMC7440785")
output_dir: PDF 保存目录的绝对路径
pmid: 可选 PMID,用于文件名前缀(默认空)
Returns:
成功返回 "OK: <bytes> bytes",失败返回 "FAIL: <error>"
Inputs: pmcid (required), output_dir (required), pmid. Returns: result
get_download_reportA
读取指定目录下的 download_report.txt 下载报告内容。
Args:
output_dir: 之前批量下载时指定的输出目录
Returns:
报告文件全文。若文件不存在返回 "报告不存在"
Inputs: output_dir (required). Returns: result
lookup_pmcidA
通过 NCBI elink API 查询 PMID 对应的 PMCID。
Args:
pmid: PubMed ID(如 "42534757")
Returns:
PMCID(如 "PMC7440785");若文章未在 PMC 开放获取则返回空字符串
Inputs: pmid (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool handles a distinct stage of the PDF download workflow: identifier lookup, single download, batch download, and report retrieval. There is no functional overlap between them, so an agent can clearly select the right tool for a given task.
All tool names follow a predictable snake_case pattern with action-first naming: lookup_pmcid, download_single_pdf, batch_download_pdfs, get_download_report. The naming clearly communicates both the action and the target, making the set easy to navigate.
Four tools is well-scoped for a focused PDF downloader server. Each tool serves a necessary part of the workflow without unnecessary redundancy or excessive surface area.
The tool set covers the full end-to-end workflow: converting PMIDs to PMCIDs, downloading individual PDFs, handling batch downloads with retries, and retrieving a final report. No obvious gaps exist for the stated purpose of downloading PMC PDFs.
Maintenance
Related MCP Connectors
Auditable MCP server for PubMed, Europe PMC, ClinicalTrials.gov, and bioRxiv/medRxiv queries
PubMed MCP — wraps the NCBI E-utilities API (biomedical literature, free, no auth)
Europe PMC MCP — biomedical literature.
PubTator 3 MCP — biomedical entity search, literature search with entity highlighting, and…
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceAn MCP server implementation that enables searching and retrieving research articles from PubMed with specific focus on open access content filtering and full-text link retrieval.8 npm3-
- AlicenseAqualityDmaintenanceAn MCP server for downloading academic papers from multiple sources using intelligent routing and year-aware priority selection. It enables users to retrieve metadata and download single or batch PDFs by DOI or URL.321 PyPI3MIT
- AlicenseAqualityDmaintenanceA local MCP server enabling PubMed, PMC, and iCite API access via stdio for tools like search, fetch, full text, and citation counts.102MIT
- AlicenseAqualityCmaintenanceMCP server for downloading academic papers from DOI or title, resolving references, and generating citations. Supports batch downloads, multiple mirrors, and optional Unpaywall integration.112MIT