Context7:把最新文档塞进 Agent 的上下文
结论
Context7 不负责写代码,负责在写之前把「当前版本的官方文档」放进上下文。它暴露两个工具:先按库名解析 ID,再按问题取文档片段,返回结果带源码链接,比让模型回忆 API 稳定得多。
它解决什么问题
框架升级快,模型训练数据里的 API 经常过期。凭记忆写出来的代码可能「看起来对」,运行才发现参数改名或目录结构变了。搜索文档又要人工复制,而且很难判断搜到的是哪个版本。Context7 把文档检索做成 MCP 工具:Agent 可以先确定库和版本,再取相关片段,减少版本错配。
我的实验
用 MCP Inspector 直接调用:
npx @modelcontextprotocol/inspector --cli \
npx -y @upstash/context7-mcp@4.6.0 \
--method tools/call --tool-name resolve-library-id \
--tool-arg libraryName=Nuxt \
--tool-arg query="Nuxt 4 app directory structure"
返回了 /nuxt/nuxt、/websites/nuxt、/llmstxt/nuxt_llms_txt 等多个 ID,并列出 v3.16.0、v4.0.0 等版本。随后用 /nuxt/nuxt 查询「server routes 放在哪、怎么用 defineEventHandler」,返回了带 server/api、server/routes 说明的代码片段和官方文档链接。
限制
- 同名库可能有多个 ID,信誉和基准分不同,选错会拿到旧内容;能指定版本时优先带上版本。
- 查询会发到 Context7 的 API,不要放密钥、私有代码或用户数据。
- 文档片段仍需自己判断是否适用于当前版本,不能替代实际运行。
- 它只解决「查文档」,不解决依赖安装、配置和运行时错误。
适合谁
经常和快速迭代的框架、SDK 打交道的人。只用稳定且熟悉的库时,收益有限。