Skip to main content
Glama
gjjisadog

scipdf-mcp

by gjjisadog
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

scipdf-mcp

一键安装的 学术论文 PDF 下载 工具：MCP Server + Skill + CLI（v0.2）。

用户要论文 → 解析 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 --update
git 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: academic-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 服务。

MCP Tools / Resources / Prompts

Tool

说明

download_paper

单篇；返回 path、cached、citation、错误 code

download_papers

批量去重 + scipdf-manifest.json

resolve_doi

Crossref + OpenAlex

parse_references

bib/ris/粘贴列表抽 DOI

list_mirrors / check_mirrors

配置与健康缓存探测

list_papers

已下载列表

open_paper

系统默认打开 PDF

format_citation

APA / GB/T / BibTeX

reload_config

热加载配置

  • Resource: papers://list

  • Prompt: download_papers_batch

错误码：DOI_NOT_FOUND / AMBIGUOUS_DOI / MIRROR_BLOCKED / ALL_SOURCES_FAILED / PDF_NOT_IN_DB 等。

环境变量（节选）

变量

含义

默认

SCIPDF_DOWNLOAD_DIR

保存目录

~/Documents/Papers

SCIPDF_UNPAYWALL_EMAIL

可选，Unpaywall 真实邮箱

未设 = 不用 OA

SCIPDF_PREFER_OA

为 true 时才在 Sci-Hub 前试 OA

false（默认 Sci-Hub）

SCIPDF_ALLOW_SCIHUB

是否允许 Sci-Hub（主路径）

true

SCIPDF_FILENAME_STYLE

doi 或 author_year_title

doi

SCIPDF_PDF_HOSTS

直连 PDF 主机

sci.bban.top/pdf/

SCIPDF_MIRRORS

HTML 镜像列表

内置

SCIPDF_DEBUG=1

调试日志

off

SCIPDF_HEALTH_TTL_MS

镜像健康缓存

15min

Unpaywall（可选，非强制）

默认只走 Sci-Hub，无需任何邮箱。

若要优先合法 OA，需同时配置：

export SCIPDF_UNPAYWALL_EMAIL="你的真实邮箱@gmail.com"
export SCIPDF_PREFER_OA=true

Unpaywall 要求真实邮箱（统计用量，不收费）。example.com 无效。

配置

行为

默认（无邮箱 / 无 PREFER_OA）

只走 Sci-Hub

只设邮箱

仍默认 Sci-Hub（可用 unpaywall 命令单独查询）

邮箱 + PREFER_OA=true

先 OA，失败再 Sci-Hub

ALLOW_SCIHUB=false + 邮箱 + PREFER_OA

仅 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:all

CI：GitHub Actions 上 Node 20/22 build + test。

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

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