一句话定位：把库的最新文档塞进上下文，治住 AI 编出不存在的 API。

写代玛时最坑的不是模型不会写，是它写得“很像但对”——用了一年前训练数据里的旧接口，或者凭空造出一个从未存在的方法。Context7 干的事很单一：你问某个库怎么用，它从源头拉当前版本的真实文档和示例，直接注入上下文。它有两种形态：一个 MCP 服务器（托管端点 https://mcp.context7.com/mcp），以及一个 CLI 加技能的组合（npx ctx7 setup）。MIT 许可，仓库在 upstash/context7。

核心能力

一、两个工具就能完成“找库 + 查文档”
MCP 侧只有两个工具：resolve-library-id 把“next.js”这种通用名解析成 Context7 的库 ID（按相关性排序），query-docs 用库 ID + 问题拉取相关文档，还能传 language 优先返回某个语言的示例。工具少的好处是不占多少上下文，也不会让模型在十个相似工具里选错。

二、版本感知，能指定到具体大版本
提示词里写“Next.js 16”，它会自动匹配对应版本文档。这一条比“给我最新文档”重要得多：升级前的项目不能用新版本的 API 写法，把它当成“总是给我最新的”反而会错。实际用法是在提问时把版本号带上，而不是指望模型自己知道你的 package.json。

三、两种接入模式，不强制上 MCP
npx ctx7 setup 会引导你选 CLI + Skills 还是 MCP：前者装一个技能，教 Agent 用 ctx7 library <name> <query> 和 ctx7 docs <libraryId> <query> 两条命令去查；后者注册 MCP 服务器让 Agent 原生调用。CLI 模式的好处是不占工具位，适合工具已经很多的客户端；MCP 模式的好处是模型能自己决定什么时候查。

四、跳过库匹配，直接给 ID 更快
在提示词里直接写 /supabase/supabase 这类库 ID，就跳过了 resolve-library-id 这一步，少一次往返。高频使用的库（Next.js、Supabase、MongoDB）把 ID 记住，能明显减少等待。也可以配一条常驻规则：“涉及库/API 文档时总是用 Context7”，让 Agent 自己去查。

五、接入面宽，30+ 客户端都有说明
官方文档给了 30 多个客户端的配置，插件目录里也有 Claude Code、Cursor、Codex 的现成包。团队里不同人用不同客户端时，不用为每个工具重写一份接入文档。

使用上手

  1. 确认 Node 版本：npx ctx7 setup 需要 Node.js 22.13 或更新。
  2. 一键装：跑 npx ctx7 setup，走 OAuth 认证，它会自动生成 API Key、并按你指定的客户端（--cursor、--claude、--opencode）装好对应配置。
  3. 或手动接 MCP：客户端里填 https://mcp.context7.com/mcp，请求头加 Authorization: Bearer <你的 Key>；Key 在 https://context7.com/dashboard?tab=settings 免费拿。
  4. 验证：问一句“用 /supabase/supabase 的库 ID，告诉我当前版本怎么写行级权限”，看它是不是返回带版本的真实示例。
  5. 加一条常驻规则：把“需要库文档时先用 Context7”写进项目规则文件，否则模型默认还是会凭记忆写。

优点与不足

优点：

  • 直接治幻觉 API，比反复纠正提示词有效。
  • 版本感知，能指定大版本，适合升级期项目。
  • CLI 与 MCP 双模式，工具位紧张的客户端也能用。
  • MIT 许可，Key 免费获取。

不足：

  • 文档由社区贡献，官方明确表示不保证准确、完整或安全，遇到可疑内容要自己判断。
  • 仓库只开源了 MCP 服务器源码，API 后端、解析与爬虫引擎都是私有的。
  • 依赖网络，内网断网环境不可用；需要离线文档的场景不适用。
  • 免费 Key 有速率限制，高频查询可能被限流。

适合谁

  • 经常跟第三方库打交道、被旧版 API 示例坑过的开发者。
  • 正在做版本升级（如 Next.js 大版本跳级）的团队。
  • 不适合：完全自研、不依赖外部库的项目，以及要求全离线内网的场景。

下载与访问

许可证与获取

项目说明
许可证MIT（仅 MCP 服务器源码；后端私有）
传输方式远端 HTTP（托管端点），Bearer Token 鉴权
安装npx ctx7 setup，或客户端手工填端点
费用免费使用，API Key 免费申请，速率限制以官网为准

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。