跳到主要内容
Ed. notes

Context7:把最新文档塞进 Agent 的上下文

工具 · 2026-11-10

  • MCP
  • 文档
  • 开发工具

结论

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 打交道的人。只用稳定且熟悉的库时,收益有限。

继续探索