S1哥 今日赠品 · 2026-10-31
配套教程：https://x.com/swordBluesy/status/2116477247414841853
来源：智谱 Z.AI 官方开发者文档 Zread MCP Server 页（工具 search_doc、get_repo_structure、read_file，只读公开 GitHub 仓库）。提示词是 S1哥 自己写的，不是官方原话。用法：把 owner/repo 换成真实仓库，例如某组织名/某仓库名。 一、接入检查（做一次） 1. Claude Code 一键命令（把 your_api_key 换成你的 Key）：claude mcp add -s user -t http zread https://api.z.ai/api/mcp/zread/mcp --header "Authorization: Bearer your_api_key" 2. 重启客户端，在 MCP 列表里看到 zread 和三个工具：search_doc、get_repo_structure、read_file 3. 报 Invalid access token：查 Key 是否复制全、是否激活、余额是否够、Bearer 后面是否有空格 二、提示词合集（复制后替换 owner/repo） 1. 选库体检：我想评估开源库 owner/repo 能不能引入。请用 zread 先搜它的文档，再看目录结构，最后读最关键的两个文件，告诉我它的核心思路、最近的维护情况，以及你觉得最大的风险。 2. 五分钟上手：用 zread 看 owner/repo 的文档和目录结构，给我一份五步上手清单：怎么安装、最小可运行例子、入口文件在哪、常见配置在哪、哪里最容易踩坑。 3. 查报错：我遇到的报错是（贴报错）。请用 zread 在 owner/repo 的 issue 和提交记录里找类似问题，告诉我有没有已知原因和修复方式，没找到就直说没找到。 4. 读核心文件：请用 zread 的 get_repo_structure 找出 owner/repo 最核心的三个文件，再用 read_file 逐个读，用大白话讲每个文件负责什么、它们怎么配合。 5. 二选一对比：我在 A 库 ownerA/repoA 和 B 库 ownerB/repoB 之间犹豫。请分别用 zread 看文档和目录，列一张对比表：功能覆盖、文档清晰度、目录是否好懂、最近有没有人维护，最后给一个建议。 6. 找贡献入口：用 zread 看 owner/repo 的文档和 issue，帮我找三个适合新手的入门任务，并说明需要改哪些文件。 三、使用提醒 1. 只能读公开的开源仓库，仓库名要写成 owner/repo 2. 仓库不被支持时，可以去 zread.ai 搜一下 3. 让 AI 给结论时，要求它说明“哪一句来自文档、哪一句来自代码”，避免它编