Context7 — 扩展与集成 — promptgarten 🌱

Context7

★ 58.979

MCP 服务器，可将当前、版本精确的库文档直接加载到你的智能体上下文中。

Context7 解决了编程助手的一个核心问题：模型对库 API 的了解只停留在训练数据的截止时间，因此经常会建议已过时甚至根本不存在的函数。据 README 介绍，该 MCP 服务器会「直接从源头」获取当前、针对具体版本的文档和代码示例，并直接注入到智能体的 prompt 中。

技术上，Context7 提供两个 MCP 工具：resolve-library-id 将库名（例如「Next.js」）解析为唯一的 Context7 ID，query-docs 则根据该 ID 和具体问题获取对应文档。触发方式既可以由智能体自动完成，也可以简单地在提问后加上「use context7」，例如：「How do I set up Next.js 14 middleware? use context7」。

该服务以托管端点 https://mcp.context7.com/mcp 的形式运行；建议通过控制台以 OAuth 方式获取免费 API 密钥以提升速率限制，并作为 CONTEXT7_API_KEY 请求头发送。CLI 工具 ctx7 负责整个配置过程，可生成密钥并自动为 Claude Code、Cursor、OpenCode 等客户端安装集成。唯一前提：Node.js 18 或更高版本。这样一来，智能体读取的是实际所用库版本的真实文档，而不是凭记忆猜测 API 调用。

🔧 SETUP

检查前提条件：需安装 Node.js 18 或更高版本
运行安装向导：`npx ctx7 setup`——通过 OAuth 生成 API 密钥并安装集成；也可针对特定客户端，例如 `npx ctx7 setup --claude`（也支持 `--cursor` 或 `--opencode`）
或手动配置：在客户端中添加 MCP 服务器 `https://mcp.context7.com/mcp`，并将 API 密钥作为 `CONTEXT7_API_KEY` 请求头传入（可通过 context7.com/dashboard 获取免费密钥）
测试：提出一个编程问题并附加「use context7」，例如「How do I set up Next.js 14 middleware? use context7」
如需移除：`npx ctx7 remove`

✅ 什么时候用？

使用更新频繁的框架时

在使用 Next.js、React 或刚更新的库进行开发时，加上「use context7」——智能体会读取真实版本的文档，而不是从训练知识中建议过时的 API。

消除臆造的 API 调用

如果助手反复建议当前库版本中已不存在（或从未存在）的函数，`query-docs` 会将真正有效的函数签名和代码示例带入上下文。

⛔ 什么时候不该用？

关于自己私有代码的问题

Context7 提供的是公开库的文档——对自己项目的内部结构一无所知。

更好的选择: 要理解代码库本身，应使用像 Graphify 这样的代码图谱工具，或智能体的常规文件工具。

完全离线工作

推荐的方式是使用托管端点（mcp.context7.com）——没有网络连接就无法获取任何文档。

更好的选择: 提前将所需的文档页面保存到本地，并作为文件提供给智能体。