Service Context7 为AI智能体提供最新版本文档的服务

让 AI 编程助手写一段用某个库的代码，它经常一本正经地编出不存在的 API：函数签名是两年前版本的，参数名是自己发明的。模型训练数据有时间截点，而前端框架、云 SDK 几乎每月都在改 API。你花在纠正幻觉上的时间，往往比查文档还多。

Context7 由 Upstash 开发，专门给 AI 智能体喂最新、版本精确的文档和代码示例——直接从源头拉取，塞进智能体的上下文里。提示词末尾加一句 use context7，或者装个规则自动触发就行。GitHub 上 6.3 万多 Star，已是智能体文档工具的头部项目。

项目基本信息

一、项目介绍

Context7 解决的问题非常聚焦：大模型依赖过时或泛化的库知识，产出基于旧训练数据的示例、根本不存在的 API、针对旧包版本的通用答案。它在智能体写代码的瞬间，把对应库当前版本的文档和示例直接拉进上下文。

使用方式有两种模式：CLI 加技能模式，安装一个引导智能体用 ctx7 命令取文档的技能，完全不依赖 MCP；MCP 模式，注册 Context7 的 MCP 服务器，智能体原生调用文档工具。CLI 提供 ctx7 library 按名字搜库拿 ID，ctx7 docs 按 ID 取文档；MCP 侧对应 resolve-library-id 和 query-docs 两个工具，后者还能指定语言让示例优先匹配你写的语言。

该仓库托管的是 MCP 服务器源码和配套 CLI、SDK；API 后端、解析引擎和抓取引擎是闭源的在线服务，通过 context7.com 提供。

二、核心优势

第一，信息新鲜。文档直接来自上游源头的版本化内容，示例跟着你用的版本走，而不是模型训练时的版本。

第二，接入成本低。一条 npx ctx7 setup 完成认证、发 Key、装技能或配 MCP，还能用 --cursor、--claude、--opencode 指定目标智能体。

第三，精度可控制。已知库 ID 时用斜杠语法（如 /supabase/supabase）跳过匹配直达文档；提示词里写明版本号（如 Next.js 16）自动对上对应版本的文档。

第四，客户端覆盖广。手动安装文档覆盖 30 多个 MCP 客户端，Claude、ChatGPT 都有一键添加入口。

三、适用场景

第一类是日常 AI 编码：所有涉及具体库 API 的问题都值得带上 Context7，特别是版本迭代快的前端框架和云 SDK。

第二类是团队工程规范：在 CLAUDE.md 或 Cursor 规则里加一条「涉及库文档必须走 Context7」，全组的智能体输出质量同时抬升。

第三类是维护旧版本的团队：明确指定版本号取文档，避免智能体用最新 API 改坏老项目的兼容性。

四、安装教程

一条命令完成设置，要求 Node.js 22.13 或更新版本：

npx ctx7 setup

命令会走 OAuth 认证、生成 API Key 并安装对应技能，期间选 CLI 加技能或 MCP 模式。建议先到 context7.com/dashboard 免费领一个 Key，速率限制更宽松。指定智能体安装：

npx ctx7 setup --claude

卸载用 npx ctx7 remove；如果是全局装过 CLI 的，另行 npm uninstall -g ctx7。手动配置 MCP 的，服务器地址是 https://mcp.context7.com/mcp，API Key 放在 Authorization: Bearer 头里。

常见报错：Node 版本低于 22.13 会直接拒绝运行，先升级；MCP 连接超时检查网络到 mcp.context7.com 的连通性；429 报错说明撞了免费限额，配上自己的 API Key 即可缓解。

五、使用示例

在任意支持 MCP 或技能的智能体里这样提问：

创建一个 Next.js 代理，校验 cookie 里的 JWT，
未登录用户重定向到 /login。use context7

智能体先解析出目标库和版本，再通过工具拉回当前版本文档，产出的代码用的是现行 API 而不是训练数据里的旧签名。已经知道库 ID 时可以更精确：

用 Supabase 实现邮箱密码注册。use library /supabase/supabase

命令行也能直接用：ctx7 library mongodb auth 列出匹配的库和 ID，ctx7 docs /mongodb/docs 连接池配置 输出对应的文档片段和示例。

六、常见问题

免费吗？工具和服务端开源，托管服务免费可用，领 API Key 后限额更高，商用额度另计。

文档质量有保证吗？社区贡献为主，官方明确不保证所有文档完整无误，页面有举报入口，使用时保留判断。

和模型自带的联网搜索冲突吗？不冲突，Context7 给的是版本化的文档检索，比通用搜索结果更精确。

七、总结

Context7 是那种接入成本五分钟、收益立刻显现的工具。它不改变你的工作流，只是让智能体每次写库相关代码时手里都有一份新文档。凡是让 AI 写过过期 API 代码的人，装完都会后悔没早点装。