zhihu-mcp

An MCP server that exposes Zhihu — China's largest Q&A platform — to AI agents over stdio.

This package is a thin alias: it installs zhihu-toolkit[mcp] and provides the zhihu-mcp executable. The server itself is implemented in zhihu-toolkit.

Install

uvx zhihu-mcp          # run without installing
pip install zhihu-mcp  # or install it

Requires Python 3.10+.

Use

Add the server to any MCP client (Claude Code, Claude Desktop, Cursor, …):

{
  "mcpServers": {
    "zhihu": {
      "command": "zhihu-mcp"
    }
  }
}

Then ask, for example:

Search Zhihu for articles about Rust async, pick three, and download them as Markdown.

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.

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.

MCP Registry

The repository's server.json is the manifest for the official MCP Registry. 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:

mcp-publisher login github
mcp-publisher publish

The version in the manifest must match a release that actually exists on PyPI, or the registry rejects the entry.

Links

• Source, documentation, and the full command reference: https://github.com/KrisTHL181/zhihu-cli
• The underlying toolkit: zhihu-toolkit

MIT licensed. Unofficial project, not affiliated with Zhihu.