zhihu-mcp 0.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- zhihu_mcp-0.3.0/MANIFEST.in +2 -0
- zhihu_mcp-0.3.0/PKG-INFO +82 -0
- zhihu_mcp-0.3.0/README.md +56 -0
- zhihu_mcp-0.3.0/pyproject.toml +68 -0
- zhihu_mcp-0.3.0/setup.cfg +4 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/PKG-INFO +82 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/SOURCES.txt +9 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/dependency_links.txt +1 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/entry_points.txt +2 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/requires.txt +1 -0
- zhihu_mcp-0.3.0/zhihu_mcp.egg-info/top_level.txt +1 -0
zhihu_mcp-0.3.0/PKG-INFO
ADDED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: zhihu-mcp
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: MCP server for Zhihu — one typed tool per CLI command, plus the zhihu_help and zhihu_run escape hatches. A thin alias for zhihu-toolkit[mcp].
|
|
5
|
+
Author-email: KrisTHL181 <KrisTHL181@outlook.com>
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/KrisTHL181/zhihu-cli
|
|
8
|
+
Project-URL: Repository, https://github.com/KrisTHL181/zhihu-cli
|
|
9
|
+
Project-URL: Issues, https://github.com/KrisTHL181/zhihu-cli/issues
|
|
10
|
+
Keywords: zhihu,知乎,mcp,mcp-server,ai-agent,claude
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
22
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
Requires-Dist: zhihu-toolkit[mcp]
|
|
26
|
+
|
|
27
|
+
# zhihu-mcp
|
|
28
|
+
|
|
29
|
+
<!-- mcp-name: io.github.KrisTHL181/zhihu-mcp -->
|
|
30
|
+
|
|
31
|
+
An [MCP](https://modelcontextprotocol.io) server that exposes [Zhihu](https://www.zhihu.com) — China's largest Q&A platform — to AI agents over stdio.
|
|
32
|
+
|
|
33
|
+
This package is a thin alias: it installs [`zhihu-toolkit[mcp]`](https://pypi.org/project/zhihu-toolkit/) and provides the `zhihu-mcp` executable. The server itself is implemented in `zhihu-toolkit`.
|
|
34
|
+
|
|
35
|
+
## Install
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
uvx zhihu-mcp # run without installing
|
|
39
|
+
pip install zhihu-mcp # or install it
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Requires **Python 3.10+**.
|
|
43
|
+
|
|
44
|
+
## Use
|
|
45
|
+
|
|
46
|
+
Add the server to any MCP client (Claude Code, Claude Desktop, Cursor, …):
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{
|
|
50
|
+
"mcpServers": {
|
|
51
|
+
"zhihu": {
|
|
52
|
+
"command": "zhihu-mcp"
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Then ask, for example:
|
|
59
|
+
|
|
60
|
+
> Search Zhihu for articles about Rust async, pick three, and download them as Markdown.
|
|
61
|
+
|
|
62
|
+
The server exposes one typed tool per CLI command, each with a JSON Schema derived from that command's own parameters, plus the `zhihu_help` and `zhihu_run` escape hatches. The full surface consumes a lot of context; `zhihu-mcp --groups browse,search` narrows it to selected command subtrees.
|
|
63
|
+
|
|
64
|
+
Authentication is shared with the `zhihu` CLI. Log in once with `zhihu auth login`, `zhihu auth paste`, or `zhihu auth import`, and the MCP server uses the same profile.
|
|
65
|
+
|
|
66
|
+
## MCP Registry
|
|
67
|
+
|
|
68
|
+
The repository's `server.json` is the manifest for the [official MCP Registry](https://registry.modelcontextprotocol.io). Don't hand-edit its two `version` strings: the `publish-mcp.yml` workflow rewrites them from the tag-derived build version and uploads the result as the `mcp-registry-manifest` artifact. Publish from that artifact:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
mcp-publisher login github
|
|
72
|
+
mcp-publisher publish
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
The version in the manifest must match a release that actually exists on PyPI, or the registry rejects the entry.
|
|
76
|
+
|
|
77
|
+
## Links
|
|
78
|
+
|
|
79
|
+
- Source, documentation, and the full command reference: <https://github.com/KrisTHL181/zhihu-cli>
|
|
80
|
+
- The underlying toolkit: [`zhihu-toolkit`](https://pypi.org/project/zhihu-toolkit/)
|
|
81
|
+
|
|
82
|
+
MIT licensed. Unofficial project, not affiliated with Zhihu.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# zhihu-mcp
|
|
2
|
+
|
|
3
|
+
<!-- mcp-name: io.github.KrisTHL181/zhihu-mcp -->
|
|
4
|
+
|
|
5
|
+
An [MCP](https://modelcontextprotocol.io) server that exposes [Zhihu](https://www.zhihu.com) — China's largest Q&A platform — to AI agents over stdio.
|
|
6
|
+
|
|
7
|
+
This package is a thin alias: it installs [`zhihu-toolkit[mcp]`](https://pypi.org/project/zhihu-toolkit/) and provides the `zhihu-mcp` executable. The server itself is implemented in `zhihu-toolkit`.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
uvx zhihu-mcp # run without installing
|
|
13
|
+
pip install zhihu-mcp # or install it
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Requires **Python 3.10+**.
|
|
17
|
+
|
|
18
|
+
## Use
|
|
19
|
+
|
|
20
|
+
Add the server to any MCP client (Claude Code, Claude Desktop, Cursor, …):
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"zhihu": {
|
|
26
|
+
"command": "zhihu-mcp"
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Then ask, for example:
|
|
33
|
+
|
|
34
|
+
> Search Zhihu for articles about Rust async, pick three, and download them as Markdown.
|
|
35
|
+
|
|
36
|
+
The server exposes one typed tool per CLI command, each with a JSON Schema derived from that command's own parameters, plus the `zhihu_help` and `zhihu_run` escape hatches. The full surface consumes a lot of context; `zhihu-mcp --groups browse,search` narrows it to selected command subtrees.
|
|
37
|
+
|
|
38
|
+
Authentication is shared with the `zhihu` CLI. Log in once with `zhihu auth login`, `zhihu auth paste`, or `zhihu auth import`, and the MCP server uses the same profile.
|
|
39
|
+
|
|
40
|
+
## MCP Registry
|
|
41
|
+
|
|
42
|
+
The repository's `server.json` is the manifest for the [official MCP Registry](https://registry.modelcontextprotocol.io). Don't hand-edit its two `version` strings: the `publish-mcp.yml` workflow rewrites them from the tag-derived build version and uploads the result as the `mcp-registry-manifest` artifact. Publish from that artifact:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
mcp-publisher login github
|
|
46
|
+
mcp-publisher publish
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The version in the manifest must match a release that actually exists on PyPI, or the registry rejects the entry.
|
|
50
|
+
|
|
51
|
+
## Links
|
|
52
|
+
|
|
53
|
+
- Source, documentation, and the full command reference: <https://github.com/KrisTHL181/zhihu-cli>
|
|
54
|
+
- The underlying toolkit: [`zhihu-toolkit`](https://pypi.org/project/zhihu-toolkit/)
|
|
55
|
+
|
|
56
|
+
MIT licensed. Unofficial project, not affiliated with Zhihu.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
# setuptools-scm 10 (via vcs-versioning) probes <root>/.config for per-project
|
|
3
|
+
# overrides. When pip builds this sdist from a temp dir, root="../.." resolves
|
|
4
|
+
# to the filesystem root, and an unreadable /.config aborts the build. The 9.x
|
|
5
|
+
# line has no such probe and still reads the version stored in the sdist.
|
|
6
|
+
requires = ["setuptools>=77", "wheel", "setuptools-scm>=8.0,<10"]
|
|
7
|
+
build-backend = "setuptools.build_meta"
|
|
8
|
+
|
|
9
|
+
[project]
|
|
10
|
+
name = "zhihu-mcp"
|
|
11
|
+
dynamic = ["version"]
|
|
12
|
+
description = "MCP server for Zhihu — one typed tool per CLI command, plus the zhihu_help and zhihu_run escape hatches. A thin alias for zhihu-toolkit[mcp]."
|
|
13
|
+
readme = "README.md"
|
|
14
|
+
license = "MIT"
|
|
15
|
+
requires-python = ">=3.10"
|
|
16
|
+
keywords = [
|
|
17
|
+
"zhihu",
|
|
18
|
+
"知乎",
|
|
19
|
+
"mcp",
|
|
20
|
+
"mcp-server",
|
|
21
|
+
"ai-agent",
|
|
22
|
+
"claude",
|
|
23
|
+
]
|
|
24
|
+
authors = [
|
|
25
|
+
{ name = "KrisTHL181", email = "KrisTHL181@outlook.com" },
|
|
26
|
+
]
|
|
27
|
+
classifiers = [
|
|
28
|
+
"Development Status :: 4 - Beta",
|
|
29
|
+
"Environment :: Console",
|
|
30
|
+
"Intended Audience :: Developers",
|
|
31
|
+
"Operating System :: OS Independent",
|
|
32
|
+
"Programming Language :: Python :: 3",
|
|
33
|
+
"Programming Language :: Python :: 3 :: Only",
|
|
34
|
+
"Programming Language :: Python :: 3.10",
|
|
35
|
+
"Programming Language :: Python :: 3.11",
|
|
36
|
+
"Programming Language :: Python :: 3.12",
|
|
37
|
+
"Programming Language :: Python :: 3.13",
|
|
38
|
+
"Topic :: Internet :: WWW/HTTP",
|
|
39
|
+
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
40
|
+
]
|
|
41
|
+
# No version pin on purpose: this distribution is a permanent alias that always
|
|
42
|
+
# tracks the latest zhihu-toolkit. The server implementation lives there.
|
|
43
|
+
dependencies = [
|
|
44
|
+
"zhihu-toolkit[mcp]",
|
|
45
|
+
]
|
|
46
|
+
|
|
47
|
+
[project.scripts]
|
|
48
|
+
# Intentionally duplicates the entry point in zhihu-toolkit so `uvx zhihu-mcp`
|
|
49
|
+
# resolves the executable directly from this alias package. Both point at the
|
|
50
|
+
# same function, so the duplicate is harmless.
|
|
51
|
+
zhihu-mcp = "zhihu_cli.mcp.server:main"
|
|
52
|
+
|
|
53
|
+
[project.urls]
|
|
54
|
+
Homepage = "https://github.com/KrisTHL181/zhihu-cli"
|
|
55
|
+
Repository = "https://github.com/KrisTHL181/zhihu-cli"
|
|
56
|
+
Issues = "https://github.com/KrisTHL181/zhihu-cli/issues"
|
|
57
|
+
|
|
58
|
+
# Metadata + entry point only. Nothing is packaged from this directory, and
|
|
59
|
+
# src/ belongs to the parent zhihu-toolkit project. server.json is an MCP
|
|
60
|
+
# Registry manifest, not package data; MANIFEST.in keeps it out of the sdist.
|
|
61
|
+
[tool.setuptools]
|
|
62
|
+
packages = []
|
|
63
|
+
|
|
64
|
+
[tool.setuptools_scm]
|
|
65
|
+
root = "../.."
|
|
66
|
+
fallback_version = "0.1.0"
|
|
67
|
+
# PyPI 禁止 local version（+gHASH.dDATE），去掉本地段；打 tag 的版本不受影响
|
|
68
|
+
local_scheme = "no-local-version"
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: zhihu-mcp
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: MCP server for Zhihu — one typed tool per CLI command, plus the zhihu_help and zhihu_run escape hatches. A thin alias for zhihu-toolkit[mcp].
|
|
5
|
+
Author-email: KrisTHL181 <KrisTHL181@outlook.com>
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/KrisTHL181/zhihu-cli
|
|
8
|
+
Project-URL: Repository, https://github.com/KrisTHL181/zhihu-cli
|
|
9
|
+
Project-URL: Issues, https://github.com/KrisTHL181/zhihu-cli/issues
|
|
10
|
+
Keywords: zhihu,知乎,mcp,mcp-server,ai-agent,claude
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
22
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
Requires-Dist: zhihu-toolkit[mcp]
|
|
26
|
+
|
|
27
|
+
# zhihu-mcp
|
|
28
|
+
|
|
29
|
+
<!-- mcp-name: io.github.KrisTHL181/zhihu-mcp -->
|
|
30
|
+
|
|
31
|
+
An [MCP](https://modelcontextprotocol.io) server that exposes [Zhihu](https://www.zhihu.com) — China's largest Q&A platform — to AI agents over stdio.
|
|
32
|
+
|
|
33
|
+
This package is a thin alias: it installs [`zhihu-toolkit[mcp]`](https://pypi.org/project/zhihu-toolkit/) and provides the `zhihu-mcp` executable. The server itself is implemented in `zhihu-toolkit`.
|
|
34
|
+
|
|
35
|
+
## Install
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
uvx zhihu-mcp # run without installing
|
|
39
|
+
pip install zhihu-mcp # or install it
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Requires **Python 3.10+**.
|
|
43
|
+
|
|
44
|
+
## Use
|
|
45
|
+
|
|
46
|
+
Add the server to any MCP client (Claude Code, Claude Desktop, Cursor, …):
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{
|
|
50
|
+
"mcpServers": {
|
|
51
|
+
"zhihu": {
|
|
52
|
+
"command": "zhihu-mcp"
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Then ask, for example:
|
|
59
|
+
|
|
60
|
+
> Search Zhihu for articles about Rust async, pick three, and download them as Markdown.
|
|
61
|
+
|
|
62
|
+
The server exposes one typed tool per CLI command, each with a JSON Schema derived from that command's own parameters, plus the `zhihu_help` and `zhihu_run` escape hatches. The full surface consumes a lot of context; `zhihu-mcp --groups browse,search` narrows it to selected command subtrees.
|
|
63
|
+
|
|
64
|
+
Authentication is shared with the `zhihu` CLI. Log in once with `zhihu auth login`, `zhihu auth paste`, or `zhihu auth import`, and the MCP server uses the same profile.
|
|
65
|
+
|
|
66
|
+
## MCP Registry
|
|
67
|
+
|
|
68
|
+
The repository's `server.json` is the manifest for the [official MCP Registry](https://registry.modelcontextprotocol.io). Don't hand-edit its two `version` strings: the `publish-mcp.yml` workflow rewrites them from the tag-derived build version and uploads the result as the `mcp-registry-manifest` artifact. Publish from that artifact:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
mcp-publisher login github
|
|
72
|
+
mcp-publisher publish
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
The version in the manifest must match a release that actually exists on PyPI, or the registry rejects the entry.
|
|
76
|
+
|
|
77
|
+
## Links
|
|
78
|
+
|
|
79
|
+
- Source, documentation, and the full command reference: <https://github.com/KrisTHL181/zhihu-cli>
|
|
80
|
+
- The underlying toolkit: [`zhihu-toolkit`](https://pypi.org/project/zhihu-toolkit/)
|
|
81
|
+
|
|
82
|
+
MIT licensed. Unofficial project, not affiliated with Zhihu.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
zhihu-toolkit[mcp]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|