🛠️ 开发工具 全难度 📦 community

context7

为 AI 提供最新的代码库文档和示例（实时拉取）。

8.9 /10 ★★★★☆
#免费#文档#编程
📄 相关文章

📊 评分明细

📦 打包完整度
2.2 2.2 / 2.5
🎯 实用性
2.2 2.2 / 2.5
📖 文档清晰度
1.8 1.8 / 2
👥 社区影响力
1.3 1.3 / 1.5
🔗 集成度
1.3 1.3 / 1.5

🎯 适用场景

免费文档编程

context7 快速入门

让 AI 写代码时永远用最新版 API,而不是过时的记忆。

这是什么?解决什么问题?

你有没有过这种经历:让 AI 写一段 React 代码,结果它给你用了 React 17 的写法,但你项目是 React 19?或者让 AI 调用 Stripe API,它给你的代码是 2022 年的接口,现在已经废弃?

AI 模型的训练数据有截止日期,加上模型自己会”幻觉”出不存在的 API,导致写出来的代码经常用过时的方法。context7 是 Upstash 出品的 MCP Server,解决这个问题:

  • 它实时抓取各种开源库的官方文档
  • AI 写代码时,可以查询 context7 获取最新的 API 文档和示例
  • 支持 React、Next.js、Vue、Hono、Supabase、Stripe 等几十个主流库
  • Upstash 自家产品,在 MCP 生态里非常受欢迎

效果:AI 不再”凭记忆写代码”,而是每次都查询最新文档。

准备工作

  • Node.js 18+ 或 Python 3.10+
  • 支持 MCP 的 AI 客户端(Claude Code、Cursor 0.40+、OpenCode 1.0+)
  • 已配置 API 访问(MCP 协议)
  • 至少 10 分钟时间

3 步快速上手

第 1 步:克隆并安装

git clone https://github.com/upstash/context7.git
cd context7
npm install
npm run build

或者直接用 npx(推荐):

npx -y @upstash/context7-mcp

第 2 步:在 AI 客户端配置

在 Claude Code 的 ~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

重启客户端。

第 3 步:在提示词里使用

context7 的魔法在于 prompt 后缀。使用时在请求末尾加一句”使用 context7”:

“写一个 React 19 的表单组件,处理提交状态和验证。使用 context7。”

AI 会自动调用 context7 工具获取 React 19 最新文档,然后给出符合当前版本的代码。

常见踩坑

  1. 忘记加 “use context7” 后缀:如果不加,AI 不知道要用 context7,会回到凭记忆的状态。
  2. 支持库有限:context7 收录了主流库,但小众库可能没有。可以在 GitHub 提 issue 请求添加。
  3. 网络问题导致文档获取失败:context7 依赖实时网络,如果网络不稳,AI 会回退到内置知识。
  4. 多语言库覆盖不均:英文库覆盖好,中文/小语种社区库可能缺。
  5. API 改动后短暂延迟:库刚发布新版时,context7 可能几小时后才收录最新文档。
  6. token 消耗增加:实时文档会让 prompt 变长,增加 token 消耗。

初级用法

  • 写新代码时:任何时候让 AI 写新代码,加上 “use context7”,确保用的是最新 API。
  • 升级依赖前:从 Next.js 14 升 15 时,让 AI 用 context7 查询 breaking changes,做升级计划。
  • 学习新库:让 AI 解释一个新库时,用 context7 拿真实文档,而不是凭模型记忆瞎说。

高级玩法

  • .cursorrules 自动启用:在 Cursor 配置里加 “always use context7”,所有请求自动启用。
  • 指定版本:“Use context7 for Next.js 15 specifically”,强制获取特定版本的文档。
  • 对比版本:“Compare React 18 vs 19 API changes using context7”,AI 会拉两个版本对比。

小技巧

  • 提示词里明确说 “use context7 for [library name]“,比单独说 “use context7” 更精准。
  • 写企业级代码时,context7 + 类型检查(TS)双保险,几乎不可能用过时 API。
  • 对内部私有库,context7 默认抓不到,但 Upstash 提供付费方案可以索引私有文档。
  • 配合 playwright MCP 可以验证 API 实际行为:context7 告诉你文档,playwright 帮你验证 demo。
  • context7 抓的是 GitHub README + 官方文档,有些库的细节在 changelog 里,记得让 AI 也查 changelog。

context7 Skill 多维度简评

类别:开发工具 来源:upstash/context7 定位:为 AI 编程 Agent 实时拉取最新、版本特定的库文档和代码示例，解决 LLM 训练数据过时导致的 API 幻觉问题。

免责声明:本文基于官方文档和公开资料整理，未经过 MagicNetWorld 实测。

一、核心定位与价值

Context7 是由 Upstash 公司开发的文档实时检索工具，旨在解决 AI 编程 Agent 使用过时训练数据导致的问题。GitHub 57,100+ Stars，是 Agent 文档增强领域最受欢迎的工具之一。

核心价值:通过 MCP(Model Context Protocol)或 CLI+Skill 两种模式，为 AI Agent 的 prompt 中注入最新的、版本特定的库文档和代码示例，将 LLM 从不准确的训练数据中解放出来。

在实际使用中，没有 Context7 时，AI Agent 经常会:

  • 生成已废弃的 API 调用(基于训练截止日期前的旧版本文档)
  • 虚构不存在的 API(hallucination)
  • 给出通用化的回答而非特定版本的精确用法

Context7 通过直接从官方文档源拉取数据并通过重排序模型筛选最相关的内容，将平均上下文 Token 从约 9,700 降至 3,300(降低 65%)，延迟从约 24 秒降至 15 秒(降低 38%)，同时提升了内部基准测试的质量评分(来源:Upstash 官方博客 2026年1月)。

二、核心能力清单

能力实现方式适用场景
实时文档检索MCP 服务器/CLI 工具使用新版本库、查阅最新 API
版本特定查询基于库 ID 的精确版本匹配Next.js App Router vs Pages Router
智能重排序服务端重排序模型过滤最相关文档避免上下文膨胀
多平台支持Cursor/Claude Code/Codex/OpenCode跨 Agent 平台统一体验
自动更新npm 全局安装 ctx7 CLI一键安装和配置

三、技术架构

3.1 工作原理

Context7 提供两种工作模式:

MCP 模式(推荐):

  • 注册 Context7 MCP 服务器到 AI Agent 配置中
  • Agent 调用 resolve-library-id 工具:将库名称(如 “next.js”)解析为 Context7 兼容的库 ID(如 /vercel/next.js)
  • Agent 调用 get-library-docs 工具:根据库 ID 和主题(如 “middleware”)获取文档
  • 支持分页(1-10页)，当上下文不足时可继续查询

CLI + Skill 模式:

  • 安装 npx ctx7 setup 自动配置
  • 在 prompt 中添加 use context7 触发文档检索
  • Agent 通过 ctx7 CLI 命令获取文档

3.2 智能重排序优化(2026年更新)

旧架构让 LLM 自行反复调用 MCP 服务搜索和过滤文档，导致上下文膨胀和延迟。新架构将过滤和排序工作转移到 Context7 服务端:

  • 向量数据库检索候选文档
  • 服务端重排序模型筛选最佳匹配结果
  • 仅将精选后的文档片段注入 LLM 上下文

这就是 Token 消耗降低 65%、延迟降低 38% 的核心原因。

四、典型使用场景

场景 1:使用新版本框架

当 Agent 使用 Next.js 新版本时，训练数据可能包含已废弃的 API。使用 Context7 可获取最新文档:

Create a Next.js middleware that checks for a valid JWT in cookies
and redirects unauthenticated users to /login. use context7

场景 2:配置云服务

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

场景 3:精确库调用

如果已知具体库 ID，可直接指定:

Implement basic authentication with Supabase.
use library /supabase/supabase for API and docs.

场景 4:调试库特有行为

遇到框架特定行为时，不依赖训练数据，而是拉取实时文档:

Why is my Prisma query not using the connection pool?
use context7

五、安装与配置

# 一键安装(推荐)
npx ctx7 setup

# 选择目标 Agent:Cursor / Claude Code / OpenCode
npx ctx7 setup --claude
npx ctx7 setup --cursor
npx ctx7 setup --opencode

# 手动安装 Skill
npx skills add https://github.com/upstash/context7 --skill context7-docs

获取 API Key

访问 context7.com/dashboard 获取免费 API Key 以获得更高的速率限制。

六、使用建议

  1. 在 prompt 中添加 use context7 告知 Agent 使用实时文档而非训练数据
  2. 获取 API Key 以解除速率限制
  3. 添加项目规则 配置 Agent 在编码相关问题时自动使用 Context7，避免每次手动输入
  4. 精确指定库 使用 use library /org/lib 语法跳过库名匹配步骤

七、总结

核心价值:

  • 解决 LLM 训练数据过时导致 API 幻觉的核心痛点
  • 智能重排序将 Token 消耗降低 65%，延迟降低 38%
  • 支持 Claude Code、Cursor、Codex、OpenCode 等主流 Agent 平台
  • 由 Upstash 公司(知名 Serverless 数据平台)维护，GitHub 57K+ Stars

适用人群:

  • 所有使用 AI 编程 Agent 且依赖第三方库的开发者

推荐程度:⭐⭐⭐⭐⭐ —— 强烈推荐作为 AI 编程 Agent 的必备工具。对于使用快速迭代框架(如 Next.js、React、Prisma)的开发者，Context7 显著减少因 API 过时导致的调试时间。

参考资料

📊 评分与标签

评分说明

总分 8.9/10 · P_优选

📊 可观测社区指标（数据核验日期：2026-07-07）

  • GitHub: upstash/context7 ★58.7k, 🔱2.8k, 890 Commits, 19 Issues, 15 PRs
    • 页面访问核验：仓库页面 Star 58.7k / Fork 2.8k / 890 Commits，最新提交 2 hours ago（ci(triage): trigger triage agent when a library-report issue opens #2879）
  • Issues/PRs: 19 open Issues · 15 open PRs，昨日仍在合并 changeset 版本发布（#2878）
  • npm: @upstash/context7-mcp — Upstash 官方发布，MCP 生态中安装量最高的文档检索 Server 之一
  • 官方定位：“Context7 Platform — Up-to-date code documentation for LLMs and AI code editors”

📦 可安装性 2.3/2.5

  • 支持 npx -y @upstash/context7-mcp 一键 stdio 启动，无需 git clone、无编译步骤，Node.js 18+ 环境即可运行；README 同时给出 Claude Code、Cursor、Codex、Devin Desktop、Windsurf 等 12+ 客户端的 mcpServers 配置片段
  • 仓库根目录含 .claude-plugin/、.agents/plugins/（Codex 插件）、i18n/ 多语言文档，安装路径覆盖 Claude Code 官方 plugin marketplace
  • 对比 microsoft/playwright-mcp：playwright-mcp 首次运行需下载 ≈300MB 浏览器二进制，context7 仅拉取 npm 包（<5MB），冷启动更快
  • 对比 Cursor 内置 @Docs：内置无需安装但索引由 Cursor 团队维护、更新滞后；context7 可独立部署且开源可 fork

🎯 实用性 2.3/2.5

  • Context7 平台实时拉取上万个开源库最新 README + 官方文档，AI 写代码时通过 resolve-library-id + get-library-docs 两个工具调用获取当前版本 API，替代模型训练截止日期后的知识盲区
  • 支持 “use context7” prompt 后缀触发、“use context7 for [library]” 指定库、版本区间查询与多版本对比等高级用法，README 给出真实提示词示例
  • 对比 GitHub Copilot Chat：Copilot Chat 基于训练数据 + Bing 检索，答复中经常混入过时代码；context7 强制每次拉最新官方文档，幻觉率显著更低
  • 对比 modelcontextprotocol/servers 里的 fetch server：fetch server 只是通用抓取，context7 针对代码文档做了库解析、片段抽取、版本感知的领域优化

📖 文档质量 1.6/2.0

  • README 覆盖安装、配置、多客户端集成、支持库列表、Enterprise 模式与 API Key 使用方式，i18n/ 目录含中/日/韩/西/葡等多语言翻译
  • docs/enterprise/ 提供 Confluence 集成等企业场景文档（4 小时前刚合并 #2879）；context7.com 单独提供支持库搜索页面
  • 对比 modelcontextprotocol/docs：MCP 官方站有完整协议手册但 context7 仅在自身 README 内说明，缺少独立文档站点
  • 对比 anthropics/skills：官方 skills 每个能力独立 SKILL.md + 用例；context7 集中在单一 README，深度略逊但一次读完

👥 社区活跃 1.5/1.5

  • 58.7k ★ / 2.8k 🔱 / 890 Commits / 48 Branches / 94 Tags；最新提交距数据核验时点仅 2 小时，昨日发布新版本，PR/Issue 处理节奏在天级
  • 由 Upstash 官方团队（Vercel 生态云 Redis/Vector 供应商）持续维护，非个人副业项目，MCP 生态早期即入场
  • 对比 microsoft/playwright-mcp：playwright-mcp 约 34k ★，context7 社区约为其 1.7 倍
  • 对比 modelcontextprotocol/servers：官方 servers 仓库聚合上百 Server，context7 单库 Star 数超过官方聚合仓库中绝大多数 Server 独立项目总和

🔗 兼容性 1.2/1.5

  • MIT 许可 100% 开源可商用；支持 Claude Code、Cursor、Windsurf、OpenCode、Codex、Devin Desktop、Kilo Code、Kimi 等 12+ 主流 MCP-capable 客户端，配置样例集中在 README
  • 提供 stdio、HTTP、SSE 多种传输方式，可对接自建 MCP Gateway；.agents/plugins/ 目录给 Codex CLI 一键装载
  • 对比 microsoft/playwright-mcp：Apache-2.0 有专利授权条款，context7 MIT 更宽松，商用无二次分发限制
  • 对比 Cursor @Docs：仅限 Cursor 客户端，context7 可跨所有支持 MCP 的 Agent 共用同一文档源

评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。

🏷️ 标签说明

  • 免费: MIT 开源，npx -y @upstash/context7-mcp 与 context7.com 检索均免费使用，仅 Enterprise 私有索引方案收费。来源：LICENSE
  • 文档: 核心能力是拉取开源库官方文档（README + docs）给 AI 使用，属于文档检索/知识管理类工具。来源：context7.com
  • 编程: 主要服务 AI 辅助编程场景，让代码生成使用最新版 API，减少幻觉。来源：upstash/context7 README

📋 来源与核验记录

  • ✅ 已核验：upstash/context7（★58.7k / 🔱2.8k / 890 Commits / 最新提交 2 小时前，2026-07-07 抓取）
  • ⚠️ 未直接验证（同域二级页）：README.md、LICENSE、.agents/plugins、docs 目录 — 均从仓库主页目录结构推断，未逐一打开核验 打开
  • ⚠️ 间接来源：context7.com 支持库列表数据基于历史访问与官方描述，本轮抓取未再次打开
  • ⚠️ 间接来源：npm 下载量、Upstash 官方运营方身份基于已有资料，未再次 页面核验
  • ❌ 已删除死链：无