dsh-plugin-zhihu-search

4. MCP（高频使用）

MCP 默认使用 compact，只暴露三个常用工具和一个按需入口：

Codex 可以直接全局注册：

codex mcp add zhihu -- uvx zhihu-search serve --tools compact
codex mcp get zhihu

第二条命令应显示 enabled: true、command: uvx，且参数包含 zhihu-search serve --tools compact。注册成功后新建或重新打开 Codex 任务；新任务仍未出现工具时再重启客户端。

command: uvx
args:    zhihu-search serve --tools compact

档位	暴露内容
compact（默认）	search、ask、trending、other
knowledge	compact 加 3 个知识库工具
user	compact 加 5 个用户数据工具
office	compact 加 2 个 PDF 和 2 个 PPT 工具
full	全部 16 个工具

档位和工具名可以逗号混写，结果取并集，例如 knowledge,user 或 compact,knowledge_search。只写工具名则是严格 allowlist，例如 search,ask,pdf_status。

other 管理当前 MCP 会话中的低频工具：

• enable：展开 5 个用户数据工具、3 个知识库工具、2 个 PDF 工具和 2 个 PPT 工具。
• disable：收起这 12 个工具。
• reset：恢复启动时的工具集合。

只要选择里出现档位名，other 就能管理全部 12 个低频工具；纯工具名的严格 allowlist 下，它只能管理列表里已经允许的低频工具，不能越过开关。

也可以用 ZHIHU_MCP_TOOLS 设置默认配置；命令行 --tools 优先于环境 变量。常用写法：

uvx zhihu-search serve --tools knowledge   # 自建知识库检索常驻可见
uvx zhihu-search serve --tools full        # 一次暴露全部显式工具

通用 JSON 配置：

{
  "mcpServers": {
    "zhihu": {
      "command": "uvx",
      "args": ["zhihu-search", "serve", "--tools", "compact"]
    }
  }
}

注册 MCP 后，zhihu-search Skill 会优先使用这三个核心工具，避免重复执行 同一条 CLI 查询。

客户端指南：

• Codex
• Claude Code
• OpenCode
• HanaAgent

PDF / 知识库本机上传和 OAuth token 交换仍只允许 CLI/Python 执行，不会 成为模型可调用的工具。