scipdf-mcp
Enables downloading academic papers by resolving DOIs via Crossref and OpenAlex, manages local paper library, and provides citation formatting.
Click on "Install 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., "@scipdf-mcpdownload paper 10.1038/nature12373 and get citation"
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.
scipdf-mcp
一键安装的 学术论文 PDF 下载 工具:MCP Server + Skill + CLI(v0.3)。
用户要论文 → 解析 DOI(Crossref/OpenAlex)→ 下载 → 返回本地 path + 引用合规提示:请自行确认当地法规与机构政策。本工具仅供个人科研学习自用。
仓库: https://github.com/gjjisadog/scipdf-mcp
给 AI / 一键安装
请按仓库 AGENTS.md 安装 scipdf-mcp:
git clone https://github.com/gjjisadog/scipdf-mcp.git
cd scipdf-mcp && bash install.sh
重启客户端后用 /scipdf 测试。更新:bash install.sh --updategit clone https://github.com/gjjisadog/scipdf-mcp.git
cd scipdf-mcp
bash install.sh
# 更新
bash install.sh --update要求:Node.js ≥ 20。安装后会注册 MCP + Skill,并做 CLI 自检。
Related MCP server: paper-fetch-mcp
使用
Agent: /scipdf 下载:Nanometre-scale thermometry in a living cell
CLI:
node dist/index.js download 10.1038/nature12373
node dist/index.js download --title "Nanometre-scale thermometry in a living cell"
node dist/index.js batch 10.a/b 10.c/d
node dist/index.js resolve "some title"
node dist/index.js parse refs.bib
node dist/index.js list
node dist/index.js check-mirrors无参数启动 = MCP stdio 服务。
下载顺序与数据源
默认路径(无需邮箱):
(可选)Unpaywall OA # 仅当 SCIPDF_UNPAYWALL_EMAIL + SCIPDF_PREFER_OA=true
→ pdfHosts 直链 PDF # 如 sci.bban.top
→ scihubMirrors HTML 镜像 # 逐个解析页面中的 PDF 链接健康缓存会跳过近期失败的镜像(SCIPDF_HEALTH_TTL_MS,默认 15 分钟)。可用 check-mirrors / MCP check_mirrors 探测。
默认 pdfHosts
主机 | 说明 |
| 优先尝试的 DOI 直链主机 |
默认 Sci-Hub 镜像(DEFAULT_MIRRORS)
内置 15 个 HTML 镜像(以 src/config.ts / config.example.json 为准):
镜像 | 备注 |
| 传统域名 |
| 传统域名 |
| 传统域名 |
| 传统域名(部分网络较慢或拦截) |
| 传统域名 |
| 传统域名 |
| 传统域名(部分网络 DNS 失败) |
| 已实测可下 PDF |
| 已实测可下 PDF |
| 已实测可下 PDF |
| 已实测;可能跳转 usualwant |
| 已实测可下 PDF |
| 已实测;可能跳转 pismin |
| 已实测可下 PDF |
| 已实测可下 PDF |
镜像可用性随地区与封锁变化;列表仅作默认回退,不是可用性保证。
自定义镜像
环境变量(逗号 / 分号 / 换行分隔):
export SCIPDF_MIRRORS="https://sci-hub.vg/,https://www.pismin.com/"
export SCIPDF_PDF_HOSTS="https://sci.bban.top/pdf/"
node dist/index.js check-mirrors
node dist/index.js download --force 10.1038/nature12373或复制 config.example.json → 项目目录 config.json / ~/.config/scipdf-mcp/config.json,编辑 scihubMirrors 与 pdfHosts。
配置优先级:SCIPDF_* 环境变量 > 配置文件 > 内置默认。
MCP Tools / Resources / Prompts
Tool | 说明 |
| 单篇;返回 path、 |
| 批量去重 + |
| Crossref + OpenAlex |
| bib/ris/粘贴列表抽 DOI |
| 配置与健康缓存探测 |
| 已下载列表 |
| 系统默认打开 PDF |
| APA / GB/T / BibTeX |
| 热加载配置 |
Resource:
papers://listPrompt:
download_papers_batch
错误码:DOI_NOT_FOUND / AMBIGUOUS_DOI / MIRROR_BLOCKED / ALL_SOURCES_FAILED / PDF_NOT_IN_DB 等。
环境变量(节选)
变量 | 含义 | 默认 |
| 保存目录 |
|
| 可选,Unpaywall 真实邮箱 | 未设 = 不用 OA |
| 为 true 时才在 Sci-Hub 前试 OA |
|
| 是否允许 Sci-Hub(主路径) |
|
|
|
|
| 直连 PDF 主机(逗号分隔) |
|
| HTML 镜像列表(逗号分隔) | 见上表(15 个) |
| 调试日志 | off |
| 镜像健康缓存 | 15min |
Unpaywall(可选,非强制)
默认只走 Sci-Hub,无需任何邮箱。
若要优先合法 OA,需同时配置:
export SCIPDF_UNPAYWALL_EMAIL="你的真实邮箱@gmail.com"
export SCIPDF_PREFER_OA=trueUnpaywall 要求真实邮箱(统计用量,不收费)。example.com 无效。
配置 | 行为 |
默认(无邮箱 / 无 PREFER_OA) | 只走 Sci-Hub / pdfHosts |
只设邮箱 | 仍默认 Sci-Hub(可用 |
邮箱 + | 先 OA,失败再 Sci-Hub |
| 仅 OA |
Grok 示例(可选 OA):
[mcp_servers.scipdf]
command = "node"
args = ["/path/to/scipdf-mcp/dist/index.js"]
env = {
SCIPDF_DOWNLOAD_DIR = "/Users/you/Documents/Papers",
SCIPDF_UNPAYWALL_EMAIL = "you@gmail.com",
SCIPDF_PREFER_OA = "true"
}见 config.example.json。
开发
npm install && npm run build && npm test
npm run install:allCI:GitHub Actions 上 Node 20/22 build + test。
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- 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.Last updated32MIT
- AlicenseAqualityAmaintenanceMCP server that turns DOI, URL, or paper titles into structured Markdown full-text with metadata and assets, enabling AI agents to read beyond abstracts.Last updated10224MIT
- AlicenseAqualityAmaintenanceComprehensive MCP server for academic research workflows, enabling paper searching across multiple sources, manuscript processing with citation placeholders, search caching, and citation export.Last updated11MIT
- Alicense-qualityCmaintenanceMCP server for searching, downloading, and reading academic papers from multiple sources such as arXiv, Google Scholar, and Elsevier.Last updated6MIT
Related MCP Connectors
Academic research MCP server for paper search, citation checks, graphs, and deep research.
The everything Zotero MCP server — Web API v3 + local API, safe writes, citations, search.
MCP server for Altmetric APIs - track research attention across news, policy, social media, and more
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gjjisadog/scipdf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server