CNKI MCP Server
Enables AI assistants to search and retrieve paper information from CNKI (China National Knowledge Infrastructure), supporting 15 search types, pagination, sorting, and detailed metadata extraction.
README
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
维护
知网改版时如何修复
- 打开浏览器开发者工具,检查知网搜索页/详情页的 HTML 结构
- 编辑
src/cnki_mcp/selectors.py,更新对应的选择器 - 每个字段支持多选择器回退,格式为
"策略:选择器",策略支持css、xpath、id
添加新的搜索类型
编辑 selectors.py 中的 SEARCH_TYPE_VALUES 和 SEARCH_TYPE_ALIASES 字典。
与原始项目的区别
本项目的改进:
- 选择器配置化 — 所有 XPath/CSS 集中在
selectors.py,知网改版只需改一个文件 - 多选择器回退 — 每个元素有多套选择器策略,一个失败自动尝试下一个
- 结构化错误处理 — 自定义异常体系,每个步骤独立容错
- 更好的反检测 — 更多反自动化检测措施
- 可维护架构 — 清晰的模块分离(浏览器管理 / 选择器配置 / 业务逻辑)
- 去掉冗余 — 移除 FastAPI 版本,专注 MCP
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.