CNKI MCP Server

知网(CNKI)论文检索 MCP 服务 —— 让 AI 助手直接搜索和获取知网论文信息。

功能

Tool	说明
search_cnki	搜索知网论文，支持 15 种搜索类型、分页、排序
get_paper_detail	从详情页提取完整元数据（标题/摘要/作者/DOI等）
find_best_match	按字符相似度匹配最相近的论文标题

Resource	说明
cnki://search-types	列出所有可用搜索类型及别名
cnki://status	查看服务运行状态

安装

前置条件

• Python >= 3.10
• uv（推荐）或 pip
• Chrome 浏览器

方式一：uvx 直接运行（推荐）

无需手动安装，配置后自动拉取：

{
  "mcpServers": {
    "cnki": {
      "command": "uvx",
      "args": ["cnki-mcp"]
    }
  }
}

方式二：从 Git 安装

uvx --from git+https://github.com/你的用户名/cnki-mcp cnki-mcp

方式三：本地开发安装

git clone <repo-url> cnki-mcp
cd cnki-mcp
uv sync
# 或 pip install -e .

配置

Claude Desktop

编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "cnki": {
      "command": "uvx",
      "args": ["--from", "e:\\data_agent\\cnki-mcp", "cnki-mcp"]
    }
  }
}

Cursor

编辑 Cursor 的 MCP 配置:

{
  "mcpServers": {
    "cnki": {
      "command": "uvx",
      "args": ["--from", "e:\\data_agent\\cnki-mcp", "cnki-mcp"]
    }
  }
}

支持的搜索类型

中文	英文别名	说明
主题	subject, theme	综合搜索（默认）
篇关摘	—	篇名+关键词+摘要
关键词	keyword, keywords	关键词搜索
篇名	title	按标题搜索
全文	fulltext, full_text	全文搜索
作者	author	作者名搜索
第一作者	first_author	第一作者搜索
通讯作者	corresponding_author	通讯作者搜索
作者单位	affiliation, institution	机构搜索
基金	fund	基金项目搜索
摘要	abstract	摘要搜索
参考文献	reference	参考文献搜索
分类号	classification	分类号搜索
文献来源	source	期刊/来源搜索
DOI	doi	DOI 精确搜索

排序方式

中文	英文
相关度（默认）	relevance
发表时间	time, date
被引	cited, citation
下载	download, downloads

使用建议

• 每次搜索建议 1-3 页，避免频繁请求触发反爬
• 搜索间隔建议 2-3 秒
• 首次运行会自动下载 ChromeDriver

维护

知网改版时如何修复

1. 打开浏览器开发者工具，检查知网搜索页/详情页的 HTML 结构
2. 编辑 src/cnki_mcp/selectors.py，更新对应的选择器
3. 每个字段支持多选择器回退，格式为 "策略:选择器"，策略支持 css、xpath、id

添加新的搜索类型

编辑 selectors.py 中的 SEARCH_TYPE_VALUES 和 SEARCH_TYPE_ALIASES 字典。

与原始项目的区别

本项目的改进：

1. 选择器配置化 — 所有 XPath/CSS 集中在 selectors.py，知网改版只需改一个文件
2. 多选择器回退 — 每个元素有多套选择器策略，一个失败自动尝试下一个
3. 结构化错误处理 — 自定义异常体系，每个步骤独立容错
4. 更好的反检测 — 更多反自动化检测措施
5. 可维护架构 — 清晰的模块分离（浏览器管理 / 选择器配置 / 业务逻辑）
6. 去掉冗余 — 移除 FastAPI 版本，专注 MCP

License

MIT