Context7 — 最新文档
模型只知道训练时的库。而 API 一直在变:Hook 换了签名、配置项改了名、框架换了新路由。Context7 插件为连接的智能体提供 Context7 (Upstash 的开源项目)的两个工具: 查找库,然后阅读它当前的文档和代码示例——针对项目实际使用的版本。
如何使用
- 在添加卡片菜单中选择 插件,在 插件 标签页打开 Context7 — 最新文档,点击 添加到画布。
- 从智能体向卡片画一条箭头。
智能体就有了两个工具:
context7_resolve_library_id——按名称(“React”“Next.js”“Django”)查找库,列出匹配项及其 Context7 id (/reactjs/react.dev)、代码示例数量、来源可信度和已索引的版本。context7_query_docs——针对一个具体问题(“useEffect cleanup function”)返回某个库的文档和示例。
当任务涉及库的 API 时,大多数智能体会自己调用它们。你也可以直接要求:“先查一下 Next.js 文档”,或在 提示词里加上 use context7。移除箭头,工具随之消失。大多数 CLI 无需重启,也不会向 CLI 安装任何东西。
无需账号
Context7 的文档索引是免费的托管服务。没有密钥时请求限额较低;从 Context7 控制台 获取免费 API 密钥可以提高限额。把密钥粘贴到卡片的 密钥与缓存 面板——它加密保存在你的电脑上,不会再次 显示,也绝不会写入文件或命令行。所有 Context7 卡片共用一个密钥。
卡片会显示剩余请求数和限额重置时间。限额用完时,卡片显示 已达限额,智能体收到清楚的提示而不是错误, 并且在重置前不再发送请求——缓存中的答案仍然可用。
缓存
每个答案在你的电脑上保存 24 小时。两个智能体问了同一个问题,或同一个智能体再问一次,答案直接来自缓存, 不消耗请求。密钥与缓存 面板显示缓存了多少答案、服务了多少次查询,并可清除缓存。
自动文档
在卡片上打开 自动文档,智能体会在你的每条提示词之前得到帮助:
- 提示词提到项目的某个依赖(来自
package.json、requirements.txt、pyproject.toml、Cargo.toml或go.mod)时,智能体会收到一行提示:这个库有最新文档可查——并附上项目声明的版本。这一步不发送请求, 所以回合开始得一样快。同一个库每半小时最多提示一次。 - 提示词里有 context7(“use context7”)并提到某个依赖或库 id(
/vercel/next.js)时,文档本身会直接 加入本轮。NeuroSquad 最多等待约一秒半;如果 Context7 更慢,智能体会收到提示,答案会缓存下来供下次使用。
自动文档支持 Claude Code、Codex、Qwen Code、OpenCode、Kilo Code、MiMo Code、pi、omp、 Antigravity CLI 和 ZCode。其他通过箭头连接的智能体同样获得这两个工具。
WSL 和 SSH 工作区
位于 WSL 内或 SSH 主机上的工作区中的智能体照常通过箭头获得这两个工具——查询由这台电脑上的 NeuroSquad 发出。自动文档会从 WSL 或通过 SSH 连接读取项目的 package.json 和其他清单文件。
卡片显示什么
- 服务状态——就绪、已达限额、离线 或 错误——以及剩余请求数和重置日期。
- 试一次查询:输入库和问题,看看智能体会得到什么。
- 最近的查询:哪个库、什么问题、哪个智能体、什么时候,以及是否来自缓存。
库名和问题会发送到 Context7 的服务器(由 Upstash 运营)。不要在问题中写入机密、密码或专有代码——工具 描述也这样告诉智能体。项目的其余部分留在你的电脑上:自动文档在本地读取依赖列表,只发送库名和问题。
来源
这两个工具来自 Context7 官方 MCP 服务器(@upstash/context7-mcp,MIT 许可证),沿用其描述;NeuroSquad
直接调用同一个 Context7 API,因此不需要额外安装或启动任何东西。文档索引本身是 Context7 的托管服务。
如果你需要完全不离开电脑的文档查询,可以改为从目录的 MCP 标签页添加一个自托管的文档 MCP 服务器。