CNKI MCP Server

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

功能

Related MCP server: AMiner MCP Server

安装

前置条件

• 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"]
    }
  }
}

支持的搜索类型

排序方式

使用建议

• 每次搜索建议 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