Context7 文档服务
为编码助手提供最新、按版本匹配的库文档和代码示例。
- Star 数
- ★ 63k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Cursor 等编码助手的开发者，希望在生成 Next.js 代码前获取对应版本的代理配置文档。
- 不适合
- 要求所有组件均可自行托管的团队
- 需要文档准确性或安全性保证的团队
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Context7 是 Upstash 提供的文档检索平台，面向编码助手提供来自源头的最新文档和代码示例。它支持两种使用方式：通过 ctx7 CLI 和技能引导助手检索文档，或通过 MCP 服务器让 MCP 客户端调用文档工具。CLI 提供 library 搜索和 docs 检索命令；MCP 提供 resolve-library-id 与 query-docs 工具。用户可在提示中指定 Context7 库 ID 或版本，以便检索对应文档。仓库包含 MCP 服务器源码，也列出 TypeScript SDK、Vercel AI SDK 工具和 pi.dev 扩展包；API 后端、解析引擎和爬取引擎是私有组件。
在 CLI 模式下，ctx7 library <name> <query> 按库名搜索并返回匹配库及其 ID，ctx7 docs <libraryId> <query> 按 Context7 库 ID 获取文档。在 MCP 模式下，resolve-library-id 根据 libraryName 和 query 查找库 ID，query-docs 使用 libraryId 和 query 检索文档，并可用 language 优先匹配代码示例语言。检索结果和示例会提供给编码助手的上下文。用户可以在请求中写明库 ID 或版本来指定检索目标。
- 使用 Cursor 等编码助手的开发者，希望在生成 Next.js 代码前获取对应版本的代理配置文档。
- 配置 Cloudflare Worker 缓存的工程师，需要检索 JSON 响应缓存示例。
- 开发 Supabase 登录流程的团队，希望查找邮箱和密码注册 API 文档。
- 维护 Node.js 项目的开发者，希望通过终端按库名查找 Context7 库 ID 并检索文档。
- 集成 MCP 客户端的团队，希望让助手原生调用库解析和文档查询工具。
如何安装或部署这个 Agent？
CLI 快速安装要求 Node.js 22.13 或更高版本。运行设置命令，通过 OAuth 认证并生成 API 密钥，然后选择 CLI + Skills 或 MCP 模式；可用选项指定目标编码助手。较高请求速率建议获取免费的 API 密钥。也可手动将 MCP 客户端配置为 Context7 服务器，并传入 Bearer API 密钥。
如何使用这个 Agent？
安装后，可以通过 CLI 搜索库并查询文档：
ctx7 library next.js "proxy configuration"
ctx7 docs /vercel/next.js "proxy configuration"在提示中写入 use context7，或提供精确库 ID 和版本以指定文档来源。使用 MCP 时，将服务器地址和 Bearer 密钥配置到客户端；README 未给出通用客户端配置文件格式。
这个 Agent 有哪些优点和局限？
- CLI 与 MCP 两种路径都能检索最新的库文档和代码示例。
- 支持按 Context7 库 ID 和版本指定检索目标，减少库匹配歧义。
- MCP 查询可传入语言参数，以优先返回相应语言的代码示例。
- 提供 CLI、MCP 服务器、TypeScript SDK 和 Vercel AI SDK 工具等多个集成包。
- CLI 要求 Node.js 22.13 或更高版本。
- 检索依赖 Context7 服务；手动 MCP 配置需要网络连接和 API 密钥，免费密钥仅被说明可提高速率。
- API 后端、解析引擎和爬取引擎为私有组件，不能从该仓库自行部署整个平台。
- 项目明确表示无法保证社区贡献文档的准确性、完整性或安全性。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Context7 文档服务 当前 | 56 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 63k | 今天 | TypeScript | — |
| Stock SDK | 71 · 存在缺口 | 代码库 / SDK免费 | ★ 2k | 17 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| Unbrowse 网站 API 客户端 | 56 · 缺口较多 | 云服务 / SaaS免费版 + 付费版 | ★ 802 | 3 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| Superset | 52 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 15k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
隐私文档具体说明发送给 API 的查询、库标识、API key、客户端信息与传输类型，也披露查询会用于重排并匿名存储；工具描述要求剔除敏感内容，故数据流和敏感信息处理得分较高。安装会进行 OAuth、生成 API key 并配置代理，但来源未说明逐项权限、确认细节、凭据保存保护或各工具的外部副作用；移除命令提供有限回退。文档说明库文档来自各自维护者，README 也披露后端、解析和抓取组件不在仓库内，因此归属可追溯但未全面核验。
README列出CLI和MCP模式及工具职责，配套资料也给出Ask API状态码；但安装文档为空，且隐私说明的“从不传输完整提示”与所发送查询可能由提示提炼而来的表述之间缺少边界细节，因而自洽性仅部分成立。依赖 API、托管服务和外部LLM提供商，来源没有可用性承诺；Ask状态码与重试提示提供一定故障处理信息。
材料明确面向使用编码代理获取库文档的场景，支持CLI、MCP及多客户端配置，也可指定库ID和版本。隐私策略、来源类型过滤和私有部署选项说明部分能力边界；触发规则可手动调用或通过客户端规则自动启用。材料没有覆盖所有环境与故障配置，因此未给满分。
README有清晰的用途、安装、工具、文档和包结构；有Node版本要求、设置与移除说明、多语言入口和用法示例。隐私、责任边界及安全报告路径有说明，MIT许可证文本完整，SECURITY.md列出支持版本和报告流程，工作区脚本及canary发布提供版本维护线索。安装文档为空，变更历史和维护责任的长期承诺在所给材料中不足，因此不满分。
查询工具返回与指定库和问题相关的文档，能为编码代理补充版本相关资料；示例展示了可复用的调用形式。其价值依赖索引质量及外部服务，文档明确不保证所有社区文档准确、完整或安全；托管重排和查询存储带来数据处理成本，材料未量化收益、费用或延迟，故成本效益只得部分分数。
工具名称、参数、安装命令、数据字段和状态码均有具体描述，部分隐私主张也说明处理用途。README、隐私文档、包元数据与安全策略可交叉印证产品结构和维护线索，但多数服务行为仅由文档陈述，仓库明确缺少后端等组件；文本区分了公开说明与社区内容质量限制，但没有独立证据支撑全部隐私及合规声明。
- 查询会发送给 Context7 API，并用于文档重排及匿名基准改进；不要在查询中包含秘密、凭据或专有信息。
- 仓库不包含 API 后端、解析引擎和抓取引擎；文档准确性、安全性及服务可用性不能仅凭这些材料独立核验。
- README要求 Node.js 22.13 或更新版本，而 Docs7 quickstart 写 Node.js 20.19 或更新版本；两者对应不同组件，使用前应确认目标工具的版本要求。