{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2kh85xn5k84d","handle":"cnki-mcp","url":"https://wellknown.network/agents/cnki-mcp","links":{"self":"https://wellknown.network/agents/cnki-mcp/record.json","html":"https://wellknown.network/agents/cnki-mcp","markdown":"https://wellknown.network/agents/cnki-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cnki-mcp","status":"https://wellknown.network/api/v1/agents/cnki-mcp/status","claim":"https://wellknown.network/agents/cnki-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cnki-mcp/claim.json","badge":"https://wellknown.network/agents/cnki-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/cnki-mcp/history","tools":"https://wellknown.network/api/v1/agents/cnki-mcp/tools"},"ard":{"identifier":"urn:air::server:cnki-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cnki-mcp","summary":"MCP server and CLI for CNKI search and metadata","description":"# CNKI-MCP: An MCP server, CLI and Skills for reach CNKI.\n\n[![PyPI version](https://img.shields.io/pypi/v/cnki-mcp.svg)](https://pypi.org/project/cnki-mcp/)\n[![PyPI Downloads](https://static.pepy.tech/badge/cnki-mcp)](https://pepy.tech/projects/cnki-mcp)\n[![License](https://img.shields.io/github/license/sepinetam/cnki-mcp)](LICENSE)\n\n> IMPORTANT：因该项目为个人学习项目且仅供学习与参考，故此不接受**任何形式的 AI 提交的问题，代码和评论**，仅接受人工编写的代码或真实的学习使用过程中发现的问题。同时，因个人能力与精力有限，没有很多的时间去审查代码，所以针对且仅针对于本人的该项目**禁止任何形式地通过 AI 扫描代码库来生成 Issue 与 PR**。\n> （没有说 AI 写的代码不好，他写的比我好多了，但考虑多方因素这个 repo 就是禁止使用 AI 扫库发现问题或提交代码，感谢理解。）\n> \n> 免责声明：该项目仅为个人学习项目，且仅供学习参考。 \n> 该项目不隶属任何公司、机构，与中国知网（下简称为知网或CNKI）无任何所属关系。 \n> 该项目不应用于非法手段，包括但不限于：批量访问知网进行搜索，以非正规途径获取知网论文，利用该项目进行违法违规的行为。 \n> 如有上述行为，本项目不构成任何因果利害关系，由使用者自行负责。最终解释权归本项目所有。\n> \n> 商标及非关联声明：项目所提及的“中国知网”“知网”“CNKI”等名称、商标及相关标识，其相关权利均归各自合法权利人所有。\n> 本项目仅在客观说明所涉及的平台、适用对象或技术功能所必需的范围内引用相关名称，不将其作为本项目自身的品牌或来源标识，亦不表示或暗示本项目获得相关权利人的授权、认可、赞助或支持。\n> 本项目为独立的非官方项目，与中国知网及其运营主体不存在隶属、代理或官方合作关系。\n> 本项目的发布、分发及使用，不构成对上述第三方商标或标识的任何使用授权。\n> 如相关权利人认为本项目存在侵犯其合法权益的情形，可向项目提交 Issue 并通过邮箱联系维护者，维护者将及时核实并依法处理。\n\n## 快速开始\n本项目提供了配套的 Skill，且同时支持 MCP，CLI，Python API 等多种使用方式，以便为研究者的 Agent 助理快速稳定地使用中国知网搜索论文查找论文。\n\n如果你是人类研究者，将下面这句话发送给你的 Agent 即可：\n```plain text\n帮我从 GitHub 上安装 SepineTam/cnki-mcp 这个项目的 skill，subagents 等，并通过命令行的形式初始化这个项目。\n成功初始化后，去查看《世界经济》这本期刊的 ISSN 号，并告诉我这个期刊在 2025 年是否发表过任何和人才引进相关的文章。\n```\n\n如果你是 Agent，参考 [CNKI-MCP 的 Agent 安装文档](./docs/install.md)\n\n## 首次初始化\n\n首次使用时运行：\n\n```bash\nuv run cnki-mcp init\n```\n\n命令会询问 Profile 名称，直接回车使用 `default`。也可以直接指定名称：\n\n```bash\nuv run cnki-mcp init --profile school\n```\n\n请在打开的浏览器中完成学校或机构认证。初始化成功后，该 Profile 会成为默认\nProfile，后续启动和检索无需重复指定。\n\n## 推荐启动方式\n\n推荐使用 HTTP。下面两条命令效果相同，默认监听 `127.0.0.1:7788`：\n\n```bash\nuv run cnki-mcp\nuv run cnki-mcp serve --transport http --host 127.0.0.1 --port 7788\n```\n\n服务启动时会打开一个持久浏览器，并在服务进程退出时关闭。项目只提供知网检索和\n文章信息读取，不提供全文下载。\n\n按 ISSN 获取某一期的全部文章 metadata：\n\n```bash\nuv run cnki-mcp tool journal --issn 1002-9621 --year 2026 --vol 1\n```\n\n这里的 `--vol` 表示知网页面上的期号。返回结果会把真正的卷号 `volume` 和期号\n`issue` 分开…","publisher":{"name":"SongTan","url":null},"homepage":"https://sepinetam.github.io/cnki-mcp/","repository":"https://github.com/sepinetam/cnki-mcp/releases","version":"0.2.1","license":null,"protocols":["mcp"],"tags":["cnki","mcp","cli","academic","papers","metadata"],"pricing":null,"endpoints":[{"url":"pypi:cnki-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"research.academic","name":"Academic Research","confidence":1,"provenance":"declared"}],"categories":["research"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"cnki-mcp","registry":"pypi","observedAt":"2026-11-03T00:27:03.160Z","publishedAt":"2026-10-28T08:58:56.701973Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cnki-mcp","url":"https://pypi.org/project/cnki-mcp/","firstSeenAt":"2026-09-09T11:31:20.806Z","fetchedAt":"2026-11-03T00:25:02.277Z","normalizedAt":"2026-11-03T00:25:02.277Z"}]},"firstSeenAt":"2026-09-09T11:31:20.806Z","updatedAt":"2026-11-03T00:27:03.160Z"}