Service Context7 为AI编程智能体提供实时精准文档

用 AI 写代码最怕一种情况：模型照着一年前的训练数据给你生成 API 调用，结果库早就升级了，方法名、参数全对不上，你还得自己对着官方文档一个个改。问题不在模型不会写，而在于它手里的「文档」是过时的。

Context7 想做的，是给编码智能体接上「实时、按版本检索的官方文档」。当你问「用 Supabase 怎么做邮箱注册」「Next.js 16 怎么配代理」时，它直接从源头拉取对应库、对应版本的文档与代码示例，塞进智能体的上下文里。这样生成的代码不再依赖过时的训练记忆，也不编造不存在的 API。

项目基本信息

一、项目介绍

Context7 是一个「把最新文档喂给 AI 编程智能体」的平台。它有两种工作模式：其一是 CLI + Skills，安装一个技能引导你的智能体用 ctx7 命令拉文档（无需 MCP）；其二是 MCP，注册一个 Context7 MCP 服务器，让智能体原生调用文档工具。

它的使用方式非常轻：在提问里加一句 use context7 或指定库 ID（如 /supabase/supabase），智能体就会去拉取该库、该版本的官方文档与示例。官方建议免费注册 API Key 以提升速率上限，但也支持手动配置 MCP 服务器地址与 Bearer Token。

二、核心优势

• 版本精准：按你提到的版本检索文档，避免「旧教程式」代码。
• 源头直取：文档与示例来自库官方源，减少幻觉 API。
• 两种接入：CLI + Skills 或 MCP，适配不同工作流。
• 广覆盖：官方维护大量库索引，支持用斜杠语法指定库与语言。
• 多客户端：提供 30+ 客户端的手动 MCP 接入指南，并配套 TypeScript SDK。

三、适用场景

• 用新版本库开发，需要最新 API 与示例。
• 编码智能体频繁「编出不存在的方法」，需要纠偏。
• 团队统一文档来源，避免各人训练记忆不一致。
• 在 Cursor / Claude Code / OpenCode 等里配置常态化文档检索。

四、安装教程

ctx7 CLI 需要 Node.js 22.13 或更高。一条命令完成鉴权与安装：

npx ctx7 setup

该命令通过 OAuth 认证、生成 API Key，并安装对应的 Skill；可用 --cursor、--claude、--opencode 指定目标智能体。手动配置 MCP 时，将服务器地址设为 https://mcp.context7.com/mcp，并在请求头用 Authorization: Bearer YOUR_API_KEY 传入密钥。

移除配置：

npx ctx7 remove

常见报错与处理：

ctx7: command not found

未使用 npx 前缀或全局安装有误，改用 npx ctx7 ...，或 npm install -g ctx7 后重开终端。

401 / unauthorized

API Key 无效或过期，重新 npx ctx7 setup 获取，或在 MCP 配置中更新 Bearer Token。

五、使用示例

在编码智能体里直接提问（加 use context7）：

Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7

指定库与版本，减少匹配步骤：

How do I set up a Next.js 16 proxy? use context7
Show me the Supabase auth API for email/password sign-up. use library /supabase/supabase for API and docs.

真实输出：智能体返回的是 Cloudflare Workers / Next.js 16 / Supabase 当前版本的官方文档片段与可运行示例，而不是一年前的旧写法。

CLI 直接检索：

ctx7 docs /supabase/supabase "email password sign-up"

六、常见问题

• 一定要 API Key 吗？ 推荐免费注册以提升速率，但也可仅用基础额度；手动 MCP 配置需传入 Key。
• 支持哪些库？ 官方持续维护大量库索引，并允许社区提交自己的库。
• MCP 和 CLI 模式怎么选？ 想让智能体原生调用文档工具选 MCP；想要轻量 Skill 引导选 CLI + Skills。
• 文档准确性谁负责？ 库文档由各库所有者维护，Context7 作为检索与解析层，不保证第三方内容绝对准确。

七、总结

Context7 解决的是 AI 编程里「文档过时导致幻觉」的顽疾。它用实时、按版本的官方文档替换模型脑中陈旧的训练记忆，让编码智能体生成的代码更贴近你正在用的那个版本。对任何依赖第三方库、又受够了「编 API」的开发者，把 Context7 接进常用编码助手都是一笔划算的配置。