
Context7 MCP 是由 Upstash 团队开发的一款创新工具,旨在解决 AI 模型使用过时或泛化文档信息的问题。它能够为大型语言模型(LLMs)和 AI 代码编辑器提供最新、特定版本的文档和代码示例,直接从源头获取并放入提示上下文中。
项目地址:https://github.com/upstash/context7
一、现有问题与 Context7 解决方案

没有 Context7 时的问题
-
❌ 代码示例基于过时的训练数据
-
❌ AI 可能产生实际上不存在的 API(幻觉)
-
❌ 针对旧版本包的通用回答
-
❌ 浪费时间验证 AI 回答的准确性
-
❌ 与 LLM 之间令人沮丧的来回交流
使用 Context7 的优势
-
✅ 最新且特定版本的文档
-
✅ 直接从源头获取的真实、可用代码示例
-
✅ 简洁相关的信息,没有冗余内容
-
✅ 个人使用免费
-
✅ 与 MCP 服务器和工具集成
二、使用方法
使用 Context7 非常简单:
-
自然地编写你的提示词。
-
在提示词开头或末尾添加
use context7或用context7。 -
获取基于最新文档的工作代码答案。
例如:
"创建一个使用 app router 的基本 Next.js 项目。use context7"
"编写一个脚本,删除 PostgreSQL 中城市为空的行。use context7"
这样,你无需切换标签页查找文档,也不会得到不存在的 API 或过时的代码生成。
三、安装与配置
Context7 支持多种 MCP 客户端,包括 Cursor、Windsurf、Claude Desktop、VS Code 等。
1、基本要求
-
Node.js >= v18.0.0
-
支持 MCP 的客户端(如 Cursor、Windsurf、Claude Desktop 等)
2、安装方式
- 通过 Smithery 安装(适用于 Claude Desktop):
npx -y @smithery/cli install @upstash/context7-mcp --client claude
- 在 Cursor、Windsurf、Claude Desktop 中安装:
-
Cursor 修改
~/.cursor/mcp.json配置文件。 -
Claude Desktop 修改
claude_desktop_config.json配置文件。
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}

- 在 VS Code 中安装:
修改 VS Code 的 MCP 配置文件:
{
"servers": {
"Context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
3、可用工具
Context7 提供两个主要工具:
-
resolve-library-id:将通用库名解析为 Context7 兼容的库 ID。 -
get-library-docs:使用 Context7 兼容的库 ID 获取库文档。
四、常见问题排查
-
ERR_MODULE_NOT_FOUND 错误:
-
尝试使用
bunx替代npx
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
- MCP 客户端错误:
-
尝试移除包名中的
@latest。 -
尝试使用
bunx作为替代。 -
尝试使用
deno作为替代。
五、测试


六、结论
Context7 MCP 通过提供最新的文档和代码示例,显著提高了 AI 编码助手的准确性和实用性。它消除了 AI 模型使用过时信息的问题,让开发者能够获得基于最新文档的准确代码答案,提高了开发效率,减少了验证和调试的时间。无论是使用 Cursor、VS Code 还是其他支持 MCP 的工具,Context7 都能轻松集成,为 AI 驱动的编码体验带来质的提升。
更多关于AI工具、Cursor、MCP相关的教程和资讯请持续关注我后续的分享!
本文完整版详见公众号:未来的回响
文章精校版参见知识星球:AI工具实战派