cnki-mcp
把中国知网(CNKI)的文献检索 → 双排序去重 → PDF 下载 → 导入 Zotero(含 PDF 自动关联)→ 元数据核对更新封装成 MCP 工具,供 Claude 等 AI 助手一键调用。
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
An MCP server that lets an AI assistant search CNKI, download article PDFs, and import them into Zotero — with built-in deduplication, citation-based sorting, and PDF metadata reconciliation.
td.quote)localhost:23119),PDF 直接上传并关联为子附件;Zotero 未运行时降级云 API(仅元数据)cnki-mcp 命令)pip install git+https://github.com/wuruiqi/cnki-mcp.git
python -m playwright install chromium # 若无系统 Chrome
git clone https://github.com/wuruiqi/cnki-mcp.git
cd cnki-mcp
pip install -r requirements.txt
python -m playwright install chromium
cp .env.example .env # 按需修改配置
pip 安装后(最简洁):
{
"mcpServers": {
"cnki": { "type": "stdio", "command": "cnki-mcp" }
}
}
克隆源码方式:
{
"mcpServers": {
"cnki": {
"type": "stdio",
"command": "python",
"args": ["/abs/path/to/cnki-mcp/server.py"]
}
}
}
所有项均可选。详见 .env.example。
提示:若需在导入后用
cnki_preview_metadata_updates核对 PDF 元数据,请先将DELETE_PDF_AFTER_IMPORT=false,或直接使用cnki_batch返回结果中自动生成的metadata_preview。
1. cnki_login_status → 检查登录态
2. cnki_open_login_page → 机构登录(如需)
3. cnki_batch "螺旋推进 散粒体" → 检索+排序+去重+下载+导入
↳ 返回 metadata_preview → 查看 PDF 与 CNKI 元数据差异
4. cnki_apply_metadata_updates → 确认后更新 Zotero 条目
cnki_apply_metadata_updates 需要 Zotero 云 API(在 .env 中配置 ZOTERO_API_KEY + ZOTERO_LIB_ID)。top_n > 20 时实际返回数量受限(分页支持规划中)。httpx(trust_env=False) 处理。captcha_wait 秒,默认 120 秒)。浏览器须保持可见(headless=False,默认已满足)。kns.cnki.net 可能把全部请求 302 到 /verify/home(滑块/点选验证),此时检索与下载都会失败——这与"是否登录"无关,连不带 JS 的 curl 也会被拦。处理方式:在浏览器里人工过一次验证(cnki_login_status 会返回 captcha: true 作为提示),或更换网络出口。cnki_login_status 采用多信号判定(会话 Cookie _shibsession_* / Ecp_session / SID_fsso / TDC_itoken,并结合页面文字),并回传 org(机构名)。注意此类登录后 www.cnki.net 顶部仍可能保留「机构登录」入口,属正常现象。httpx 独立获取,避免浏览器退出导致下载中断。签名地址为一次性,请勿复用。pytest tests/test_unit.py -v # 离线单元测试(19 个用例)
诊断脚本见 tests/(inspect_* 检查 DOM 选择器,probe_* 测试 Zotero 端点)。
实测要点、版本变更与 2026 改版适配记录见 docs/status.md。
CNKI(中国知网)文献检索·PDF下载·Zotero自动导入关联 MCP 服务器 | MCP server for CNKI literature search, PDF download, and Zotero import
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Cnki 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 CNKI(中国知网)文献检索·PDF下载·Zotero自动导入关联 MCP 服务器 | MCP server for CNKI literature search, PDF download, and Zotero import