知识记忆#RAG#代码智能体

Context7:给编程智能体查最新版的库文档

Upstash 的托管文档服务。编程智能体按库名和版本取回最新文档与示例代码,减少过时 API 和编造接口。

项目与安装文档

查看项目

https://github.com/upstash/context7

模型的训练数据总比框架发版慢半拍,写 Next.js 中间件或 Supabase 鉴权时,它很可能给出一年前的写法,甚至编一个不存在的 API。Context7 的做法是把各个库的文档和代码示例预先抓取、切好,智能体在写代码前按库名和问题查一次,拿到对应版本的片段放进上下文。

能做什么

  • 两个工具:resolve-library-id 把“next.js”这样的名字解析成 Context7 的库 ID,query-docs 用库 ID 加问题取回相关文档。
  • 指定版本:在提示里写明“Next.js 14”,它会匹配对应版本的文档;已知库 ID 时写 /vercel/next.js 可以跳过解析步骤。
  • 两种用法:MCP 模式注册服务器让智能体直接调用;CLI 加 Skills 模式装一个技能,让智能体用 ctx7 命令查文档,不走 MCP。
  • 社区收录:库的作者可以自己提交文档,覆盖面随社区增长。

适合谁

  • 用 Cursor、Claude Code 写代码,经常被过时示例坑的开发者。
  • 在用更新很快的框架(前端框架、云服务 SDK)、想让智能体先查文档再动手的团队。

接入方式

需要 Node.js 18 或更新版本。一条命令完成 OAuth 登录、生成 API key 并写入客户端配置:

npx ctx7 setup

手动配置时,服务器地址是 https://mcp.context7.com/mcp,把 API key 放在 Authorization: Bearer 请求头里。不带 key 也能用,但限流更严。

编辑点评

截至 2026-10-06 约 6.3 万 star,是编程类 MCP 里装机量最大的之一。它解决的问题很具体:让智能体在写代码前看一眼当前版本的官方用法。和让智能体自己上网搜相比,Context7 返回的是预处理过的片段,噪音少、省上下文。要清楚它的边界:仓库里只有 MCP 服务器的代码,API 后端、解析和爬取引擎都是私有的,本质上是 Upstash 运营的托管服务;文档来自社区提交,项目自己的免责声明也说无法保证每个库的准确和安全。冷门或内部库多半查不到,这时还得靠本地文档。许可证为 MIT。