MCP 服务器

cnki-mcp

Enables AI assistants to search CNKI (China National Knowledge Infrastructure), download PDFs, and import them into Zotero with automatic PDF attachment.

README

cnki-mcp

把中国知网（CNKI）的**文献检索 → PDF 下载 → 导入 Zotero（自动迁移并关联 PDF）**封装成 MCP 工具，供 Claude 等 AI 助手一键调用。

An MCP server that lets an AI assistant search CNKI (China National Knowledge Infrastructure), download article PDFs, and import them into Zotero with the PDF automatically attached.

✨ 功能

检索 CNKI 学术期刊/学位论文（表单交互，绕开失效的 URL 参数检索）
下载单篇或批量 PDF/CAJ 到本地
导入 Zotero：优先本地 connector（localhost:23119），把 PDF 直接上传并关联为子附件；Zotero 未运行时降级云 API（仅元数据）
登录态持久化：Cookie 保存/恢复，几小时内免重复登录
一键批量：cnki_batch 串起检索→下载→导入→清理暂存

🧰 MCP 工具

工具	说明
`cnki_login_status`	检查机构登录状态
`cnki_open_login_page`	打开登录页，等待手动完成机构登录并保存 Cookie
`cnki_save_cookies`	手动保存当前 Cookie
`cnki_search`	按关键词检索期刊论文
`cnki_download_pdf`	下载单篇 PDF/CAJ
`cnki_import_to_zotero`	把元数据列表导入 Zotero（可带 `pdf_path` 自动关联 PDF）
`cnki_batch`	一键：检索 → 下载 → 导入 Zotero

📦 环境要求

Python 3.10+（MCP SDK 要求）
Playwright + 系统 Chrome（或内置 Chromium）
有效的 CNKI 机构访问权限（校园网/VPN/机构账号）
可选：Zotero 7+ 桌面端（用于 PDF 自动关联）

🚀 安装

方式 A：pip 安装（推荐，提供 `cnki-mcp` 命令）

# 从 GitHub 直接安装（或 pip install cnki-mcp 若已上 PyPI）
pip install git+https://github.com/wuruiqi/cnki-mcp.git
python -m playwright install chromium   # 若无系统 Chrome

安装后即有 cnki-mcp 控制台命令，启动 stdio MCP 服务器。

方式 B：克隆源码

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                     # 按需修改配置

注册到 MCP 客户端

pip 安装后（用 cnki-mcp 命令，最简洁）：

{
  "mcpServers": {
    "cnki": { "type": "stdio", "command": "cnki-mcp" }
  }
}

uvx 免安装运行：

{
  "mcpServers": {
    "cnki": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/wuruiqi/cnki-mcp.git", "cnki-mcp"]
    }
  }
}

克隆源码方式（直接指向 server.py）：

{
  "mcpServers": {
    "cnki": {
      "type": "stdio",
      "command": "python",
      "args": ["/abs/path/to/cnki-mcp/server.py"]
    }
  }
}

⚙️ 配置（.env）

所有项均可选，路径默认相对项目根目录。详见 .env.example。

变量	默认	说明
`ZOTERO_LOCAL_API`	`http://127.0.0.1:23119`	Zotero 本地 connector 地址
`ZOTERO_API_KEY` / `ZOTERO_LIB_ID`	—	仅离线降级到云 API 时需要
`PDF_DIR`	`./downloads`	PDF 暂存目录
`PROFILE_DIR`	`./.browser_profile`	浏览器持久化目录
`COOKIE_FILE`	`./.cnki_cookies.json`	Cookie 存储文件
`DELETE_PDF_AFTER_IMPORT`	`true`	成功关联 Zotero 后删除暂存 PDF

📖 使用流程

cnki_login_status 查登录态；未登录则 cnki_open_login_page，在弹出的浏览器里完成机构登录（机构登录 → 校外登录 → 学校 → 账号密码 → 接受条款），脚本自动存 Cookie。
cnki_search "粮情监测物联网" 检索。
cnki_batch "粮情监测物联网" 一键检索+下载+导入 Zotero。