cnki-mcp
把中国知网(CNKI)的文献检索 → 双排序去重 → PDF 下载 → 导入 Zotero(含 PDF 自动关联)→ 元数据核对更新封装成 MCP 工具,供 Claude 等 AI 助手一键调用。
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirAn 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
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Cnki roda localmente via stdio.
Última verificação: 2026-10-28. CNKI(中国知网)文献检索·PDF下载·Zotero自动导入关联 MCP 服务器 | MCP server for CNKI literature search, PDF download, and Zotero import