AI 写代码老编造不存在的 API？Context7 把新版官方文档喂进上下文
用过 AI 编码助手的人多半遇到过：让它写段调用某框架的代码，函数名、参数看着像模像样，一跑就报错——模型的训练数据停在一年前，它按旧版文档写，甚至编出根本不存在的接口。Upstash 开源的 Context7 就是冲这个问题来的：2025 年 3 月上线，MIT 协议，把各类程序库当前版本的官方文档和代码示例从源头拉取，直接放进你的提示词，让 AI 动手写代码前先看新版文档。
它能做什么
- 按版本取文档：文档跟着库的版本走，问题里指定哪个版本，它就取那个版本的写法，不再新旧混着答
- 两个 MCP 工具：resolve-library-id 把库名解析成库 ID，query-docs 按你的问题取对应文档片段，检索链路简单直接
- 两种接入形态：MCP 服务器模式给支持 MCP 的客户端用；不想配 MCP 的，ctx7 命令行加技能模式同样能取文档，代理按指引调命令即可
- 提示词就能触发：prompt 里加一句 use context7 即挂载文档；明确知道用哪个库时用斜杠写法直指目标，跳过匹配步骤
- 客户端覆盖广：官方手册给了三十多种客户端的接入指引，仓库还带官方简体中文文档
怎么获取
npm 一条命令：npx ctx7 setup。它会引导浏览器完成登录认证、生成 API 密钥，再把技能或 MCP 配置自动装进你的编码代理，加 –cursor、–claude 这类参数可以定向安装。密钥在官网控制台申请，速率限制政策以官方页面为准。习惯手动配置的，用官方服务器地址加 Authorization 请求头接入，MCP 服务器对应的 npm 包是 @upstash/context7-mcp。源码仓库在 GitHub 上 Upstash 组织的 context7，GitHub 是唯一官方源。
上手怎么用
- 升级前先喂文档：框架大版本升级，先让 AI 取新版文档再动代码，改出来的是新版写法而不是旧版惯性
- 冷门库少翻文档站：写脚本用到小众库，直接问 AI 让它取文档，比自己在文档站里一层层翻快
- 斜杠写法直取：明确知道用哪个库时，prompt 里用斜杠写法写明库 ID，跳过检索一步到位
- 提版本号：问题里带上具体版本，返回的文档自动对齐到那个版本
- 定成规矩：给编码代理加一条规则——涉及库文档、接口用法、配置步骤时自动调用，不用每次手动喊
适合谁用
天天让 AI 写代码、改脚本的运维和开发者；技术栈升级频繁、被旧版示例坑过的团队；用各类编码代理干活的独立开发者。团队要是想把这套文档检索接进自己的 AI 工作流，也可以搜「贵州诚鑫致达科技」聊聊——我们给企业搭 AI 工具链时，文档时效这种坑正是常要处理的一类。