把最新的、按版本区分的库文档直接喂给你的编码 Agent。

安装

$ npx -y @upstash/context7-mcp

Context7 是什么?

Context7 出自 Upstash,针对的是编码 Agent 一个非常具体的痛点:模型训练数据滞后几个月甚至几年,于是它会自信地调用早已变更、甚至从未存在过的 API。Context7 持续索引各类库的官方文档,在提示词组装阶段把最新、最相关的片段送进上下文。

这个 MCP 服务器刻意做得很小——本质上就两个工具:一个把人类叫法的库名("next.js"、"prisma")解析成 Context7 的库 ID,另一个按你的问题拉取该库的针对性文档。可以用 npx 本地跑,也可以直接连托管端点(mcp.context7.com);API key 免费且可选,主要作用是提高速率限制。

它的定位是后台工具而非工作流工具。挂到 Claude Code、Cursor 或任何 MCP 客户端之后,Agent 在拿不准 API 细节时会自己去查——实际效果就是编造的方法签名变少了,你手动往对话里贴文档的次数也少了。

核心能力

  • 按版本感知的文档检索——答案对应你实际使用的库版本,而不是模型的训练截止日期
  • 工具面极小(解析库 ID + 拉取文档两个),几乎不占上下文窗口
  • 托管远程端点或 npx 本地运行——兼容 Claude Code、Cursor 等 30+ MCP 客户端
  • 免费 API key 可提高速率限制;轻度使用无 key 也能跑
  • 社区维护的索引,覆盖数千个主流库和框架

什么时候该用它

如果你的工作重度依赖快速迭代的框架——Next.js、LangChain 这类每季度都有 breaking change 的东西——而且经常抓到 Agent 在用过时 API,那就装 Context7。反之,如果你写的多是变化缓慢的标准库风格代码、Agent 已经有能可靠命中官方文档的联网搜索,或者依赖的是 Context7 从未索引过的公司内部库,就没必要装——它只认识公开文档,而且各库的索引质量参差不齐。

替代方案

常见问题

怎么把 Context7 加到 Claude Code?

本地方式:运行 `claude mcp add context7 -- npx -y @upstash/context7-mcp`;或者把托管端点 https://mcp.context7.com/mcp 添加为远程 MCP 服务器。触发限流的话去 context7.com/dashboard 领个免费 API key。挂上之后 Claude Code 会自动发现这两个工具,不需要在每条提示词里额外做什么。

Context7 收费吗?

常规用量下免费。MCP 服务器本身开源,托管的文档服务在低频使用时不需要账号;从 Context7 控制台领免费 API key 可以提高速率限制。Upstash 靠别的产品赚钱,目前核心的文档检索链路没有付费墙。

Context7 和让 Agent 直接联网搜索有什么区别?

联网搜索返回的是质量混杂的整页内容——博客、过期的 Stack Overflow 答案——Agent 还得自己筛。Context7 返回的是预先索引、带版本标记的官方文档片段,信息密度更高、更省 token、更不容易过期。代价是覆盖范围仅限于它索引过的库。

星标数据更新于 2026-07-02 · 每周从 GitHub API 自动刷新 · 浏览全部工具 →