MCP server and CLI for CNKI search and metadata
Project description
cnki-mcp
An MCP server for reach CNKI.
首次初始化
首次使用时运行：
uv run cnki-mcp init
命令会询问 Profile 名称，直接回车使用 default。也可以直接指定名称：
uv run cnki-mcp init --profile school
请在打开的浏览器中完成学校或机构认证。初始化成功后，该 Profile 会成为默认 Profile，后续启动和检索无需重复指定。
推荐启动方式
推荐使用 HTTP。下面两条命令效果相同，默认监听 127.0.0.1:7788：
uv run cnki-mcp
uv run cnki-mcp serve --transport http --host 127.0.0.1 --port 7788
服务启动时会打开一个持久浏览器，并在服务进程退出时关闭。项目只提供知网检索和 文章信息读取，不提供全文下载。
按 ISSN 获取某一期的全部文章 metadata：
uv run cnki-mcp tool journal --issn 1002-9621 --year 2026 --vol 1
这里的 --vol 表示知网页面上的期号。返回结果会把真正的卷号 volume 和期号
issue 分开提供。尚未发行的年份或期号会返回 IssueNotAvailable。
通过期刊名称搜索 ISSN：
uv run cnki-mcp tool issn --journal "世界经济"
搜索会忽略期刊名中的空格和标点，并返回知网搜索到的全部候选期刊。期刊目录来自
知网期刊导航页。工具每次都会通过 ISSN 重新定位期刊并获取当次有效的页面地址，
不会保存其中会失效的 p 参数。
文档
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cnki_mcp-0.1.0.tar.gz.
File metadata
- Download URL: cnki_mcp-0.1.0.tar.gz
- Upload date:
- Size: 44.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6fcbae69f60a5b4ad804b2773590f814c3f497faa3273622a86600e8b3561bbd
|
|
| MD5 |
c0c39f335f542ee9c73b35c6236f342e
|
|
| BLAKE2b-256 |
717119dceedbed290caf6f7bf8f54614ccf82fd4b9468cc8e5b680fe3fab622d
|
Provenance
The following attestation bundles were made for cnki_mcp-0.1.0.tar.gz:
Publisher:
publish.yml on SepineTam/cnki-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cnki_mcp-0.1.0.tar.gz -
Subject digest:
6fcbae69f60a5b4ad804b2773590f814c3f497faa3273622a86600e8b3561bbd - Sigstore transparency entry: 2211884186
- Sigstore integration time:
-
Permalink:
SepineTam/cnki-mcp@db770560ec38195623b4cf17ca5d51c944ae9288 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SepineTam
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@db770560ec38195623b4cf17ca5d51c944ae9288 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file cnki_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: cnki_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 65.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b93f8537483080465fe45d37f65de103d2016522effca38a66658744c16255cb
|
|
| MD5 |
39b57901b3f086d31fa58ec7dac20f85
|
|
| BLAKE2b-256 |
94074654d4a6c5906c2ac8cf69da856a564ce5a66b9ce132d2e3d5d33b3e0bd5
|
Provenance
The following attestation bundles were made for cnki_mcp-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on SepineTam/cnki-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cnki_mcp-0.1.0-py3-none-any.whl -
Subject digest:
b93f8537483080465fe45d37f65de103d2016522effca38a66658744c16255cb - Sigstore transparency entry: 2211884210
- Sigstore integration time:
-
Permalink:
SepineTam/cnki-mcp@db770560ec38195623b4cf17ca5d51c944ae9288 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SepineTam
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@db770560ec38195623b4cf17ca5d51c944ae9288 -
Trigger Event:
workflow_dispatch
-
Statement type:
