zhihu-mcp-proxy

MCP server for Zhihu Search — bridges Zhihu's official MCP-over-SSE API to stdio.

Quick Start

npx zhihu-mcp-proxy

Requires ZHIHU_ACCESS_SECRET environment variable.

Configuration

Claude Desktop / OpenClaw / any MCP client

{
  "mcpServers": {
    "zhihu-search": {
      "command": "npx",
      "args": ["zhihu-mcp-proxy"],
      "env": {
        "ZHIHU_ACCESS_SECRET": "your_access_secret_here"
      }
    }
  }
}

OpenClaw openclaw.json

{
  "mcp": {
    "servers": {
      "zhihu-search": {
        "command": "npx",
        "args": ["zhihu-mcp-proxy"],
        "env": {
          "ZHIHU_ACCESS_SECRET": "your_access_secret_here"
        }
      }
    }
  }
}

Tool

zhihu_search

| Parameter | Type | Required | Description | |-----------|--------|----------|------------------------------------| | query | string | ✅ | Search keywords, 2-100 characters | | count | number | ❌ | Number of results (1-10, default 10) |

Returns structured XML with titles, authors, content snippets, and ranking scores.

How It Works

1. On startup, connects to Zhihu's SSE endpoint with your access_secret
2. Receives the endpoint event with a session-specific message URL
3. Initializes the MCP session over that channel
4. Exposes zhihu_search as a local stdio MCP tool
5. Forwards tool calls to Zhihu and returns results

Getting an Access Secret

Apply at Zhihu Open Platform.

License

MIT