Skip to main content
Glama
Douyh123

zhihu-mcp

by Douyh123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

zhihu-mcp

知乎 MCP 服务 — 让你的 AI 助手直接操作知乎。

基于 xiaohongshu-mcp 的设计思路，使用 Python + Playwright + FastMCP 实现。

功能总览

#

MCP 工具

说明

1

check_login_status

检查知乎登录状态

2

get_login_qrcode

获取登录二维码

3

delete_cookies

删除 cookies，重置登录状态

4

publish_article

发布图文文章

5

publish_video

发布视频内容

6

search_content

搜索知乎内容（结果自动保存为 md 文件）

7

get_recommend_list

获取首页推荐列表

8

get_feed_detail

获取帖子详情（含正文和评论，自动保存为 md 文件）

9

post_comment

发表评论到帖子

10

get_user_profile

获取用户个人主页

11

reply_comment

回复评论

Related MCP server: Stride28 Search MCP

快速开始

1. 安装依赖

pip install -r requirements.txt

安装 Playwright 浏览器：

python -m playwright install chromium

2. 登录知乎

首次使用需要扫码登录，会弹出浏览器窗口：

python login.py

登录成功后 cookies 自动保存到 cookies/cookies.json。

3. 启动 MCP 服务

# 默认：端口 18060，显示浏览器
python main.py

# 无头模式（不显示浏览器）
python main.py --headless

# 自定义端口
python main.py --port 8080

MCP 服务运行在：http://localhost:18060/mcp

4. 配置代理（可选）

set ZHIHU_PROXY=http://user:pass@proxy:port   # Windows
export ZHIHU_PROXY=http://user:pass@proxy:port # Linux/Mac
python main.py

MCP 客户端接入

Claude Code

claude mcp add --transport http zhihu-mcp http://localhost:18060/mcp

Open Code

opencode mcp add
# 名称: zhihu-mcp
# 类型: Remote
# URL: http://localhost:18060/mcp

Cursor

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "zhihu-mcp": {
      "url": "http://localhost:18060/mcp"
    }
  }
}

VS Code

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "zhihu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  }
}

MCP Inspector（调试用）

npx @modelcontextprotocol/inspector
# 连接地址填 http://localhost:18060/mcp

OpenCode 技能（Skills）

项目包含两个 OpenCode 技能文件，安装后可让 AI 自动按流程操作知乎：

安装技能

将技能文件复制到 OpenCode 技能目录：

# Windows
copy skills\zhihu-auth\SKILL.md %USERPROFILE%\.agents\skills\zhihu-auth\SKILL.md
copy skills\zhihu-publish\SKILL.md %USERPROFILE%\.agents\skills\zhihu-publish\SKILL.md

# Linux / Mac
mkdir -p ~/.agents/skills/zhihu-auth ~/.agents/skills/zhihu-publish
cp skills/zhihu-auth/SKILL.md ~/.agents/skills/zhihu-auth/SKILL.md
cp skills/zhihu-publish/SKILL.md ~/.agents/skills/zhihu-publish/SKILL.md

安装后重启 OpenCode 生效。

技能说明

技能

用途

触发词

zhihu-auth

登录状态检查、扫码登录、退出登录

"登录知乎"、"检查登录"、"退出登录"

zhihu-publish

文章发布、视频发布、搜索、详情、评论

"发布到知乎"、"搜索知乎"、"查看详情"

文件输出

搜索和获取详情的结果会自动保存到 search_results/ 目录：

search_results/
├── ai岗位_20260328_173948.md          # 搜索结果列表
├── 某篇文章标题_20260328_174020.md     # 帖子详情（含评论）
└── ...

项目结构

zhihu-mcp/
├── browser/
│   ├── __init__.py
│   └── manager.py              # Playwright 浏览器管理 + 反检测
├── zhihu/
│   ├── __init__.py
│   ├── actions.py              # 知乎浏览器自动化操作
│   ├── cookies.py              # Cookie 持久化
│   └── service.py              # 服务层（桥接 actions 与 MCP）
├── server/
│   ├── __init__.py
│   └── tools.py                # MCP 工具定义与注册
├── skills/
│   ├── zhihu-auth/
│   │   └── SKILL.md             # 认证管理技能（登录/退出）
│   └── zhihu-publish/
│       └── SKILL.md             # 内容发布技能（发布/搜索/评论）
├── cookies/                    # cookies 存储目录
├── search_results/             # 搜索结果输出目录
├── main.py                     # MCP 服务入口
├── login.py                    # 登录工具
├── requirements.txt            # Python 依赖
├── pyproject.toml              # 项目配置
├── README.md
└── .gitignore

使用示例

在 AI 助手中直接使用自然语言：

帮我搜索知乎上关于 "春招" 的内容
查看第 3 条的详情
获取知乎首页推荐
帮我发布一篇知乎文章，标题是 "AI 学习笔记"，内容是（标题和内容是必要字段，注意：知乎发布内容要求字数大于9个字。） ...
对这条帖子发表评论

注意事项

  • 登录：知乎同一账号不能在多处网页端同时登录，会互相踢下线

  • Cookie 过期：如果操作提示未登录，重新运行 python login.py 扫码

  • 频率控制：建议每天发布不超过 5-10 篇，避免触发风控

  • 发布按钮：知乎编辑器的"发布设置"和"发布"是两个不同的按钮，程序会精确匹配"发布"

  • URL：知乎文章编辑器地址为 https://zhuanlan.zhihu.com/write，不是 https://www.zhihu.com/write

风险提示

  • 该项目仅供学习目的，禁止用于违法行为

  • 自动化操作可能触发知乎的风控机制，建议合理控制频率

  • 请妥善保管 cookies/cookies.json 文件，不要泄露给他人

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Xiaohongshu (RedBook) MCP

    chenningling
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables automated interaction with Xiaohongshu (Little Red Book) platform including searching posts, retrieving content and comments, and posting AI-generated comments with persistent login support.
    451
    -

  • Stride28 Search MCP

    BrunonXU
    A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to search real content from Xiaohongshu and Zhihu, supporting keyword search, note details, and question retrieval.
    8
    4
    MIT

  • zhihu-mcp

    alizeeblack-code
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to search, read, and analyze Zhihu content including questions, answers, comments, and user activities through the MCP protocol.
    4
    MIT