内容
[](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)
# Context7 MCP - 适用于任何提示的最新代码文档
[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [](https://www.npmjs.com/package/@upstash/context7-mcp) [](./LICENSE)
[](./i18n/README.zh-TW.md) [](./i18n/README.zh-CN.md) [](./i18n/README.ja.md) [](./i18n/README.ko.md) [](./i18n/README.es.md) [](./i18n/README.fr.md) [-purple>)](./i18n/README.pt-BR.md) [](./i18n/README.it.md) [](./i18n/README.id-ID.md) [](./i18n/README.de.md) [](./i18n/README.ru.md) [](./i18n/README.uk.md) [](./i18n/README.tr.md) [](./i18n/README.ar.md) [](./i18n/README.vi.md)
## ❌ 没有 Context7
大型语言模型（LLM）依赖于过时或通用的库信息。你会遇到：
- ❌ 代码示例过时，基于一年前的训练数据
- ❌ 幻觉 API，不存在的 API
- ❌ 旧包版本的通用答案
## ✅ 使用 Context7
Context7 MCP 直接从源头拉取最新、特定版本的文档和代码示例，并将其放入您的提示中。
在您的提示中添加 `use context7`（或 [设置规则](#添加规则) 以自动调用）：
```txt
创建一个 Next.js 中间件，检查 cookie 中的有效 JWT 并将未经身份验证的用户重定向到 `/login`。使用 context7
```
```txt
配置 Cloudflare Worker 脚本以缓存 JSON API 响应五分钟。使用 context7
```
Context7 直接将最新的代码示例和文档获取到您的 LLM 的上下文中。无需切换标签，无需幻觉 API，无需过时的代码生成。
## 安装
> [!NOTE]
> **推荐 API 密钥**：在 [context7.com/dashboard](https://context7.com/dashboard) 获取免费 API 密钥以获得更高的速率限制。
<details>
<summary><b>在 Cursor 中安装</b></summary>
前往：`设置` -> `Cursor 设置` -> `MCP` -> `添加新的全局 MCP 服务器`
将以下配置粘贴到您的 Cursor `~/.cursor/mcp.json` 文件中是推荐的方法。您也可以在特定项目中安装，方法是在项目文件夹中创建 `.cursor/mcp.json`。有关更多信息，请参见 [Cursor MCP 文档](https://docs.cursor.com/context/model-context-protocol)。
> 自 Cursor 1.0 起，您可以点击下面的安装按钮进行一键安装。
#### Cursor 远程服务器连接
[](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)
```json
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "您的 API 密钥"
}
}
}
}
```
#### Cursor 本地服务器连接
[](https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)
```json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "您的 API 密钥"]
}
}
}
```
</details>
<details>
<summary><b>在 Claude Code 中安装</b></summary>
运行此命令。有关更多信息，请参见 [Claude Code MCP 文档](https://code.claude.com/docs/en/mcp)。
#### Claude Code 本地服务器连接
```sh
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key 您的 API 密钥
```
#### Claude Code 远程服务器连接
```sh
claude mcp add --scope user --header "CONTEXT7_API_KEY: 您的 API 密钥" --transport http context7 https://mcp.context7.com/mcp
```
> 删除 `--scope user` 以仅为当前项目安装。
</details>
<details>
<summary><b>在 Opencode 中安装</b></summary>
将以下内容添加到您的 Opencode 配置文件中。有关更多信息，请参见 [Opencode MCP 文档](https://opencode.ai/docs/mcp-servers)。
#### Opencode 远程服务器连接
```json
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "您的 API 密钥"
},
"enabled": true
}
}
```
#### Opencode 本地服务器连接
```json
{
"mcp": {
"context7": {
"type": "local",
"command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "您的 API 密钥"],
"enabled": true
}
}
}
```
</details>
<details>
<summary><b>使用 ctx7 设置</b></summary>
为您的代码代理设置 Context7 MCP：
```bash
npx ctx7 setup
```
通过 OAuth 进行身份验证，生成 API 密钥，并为您的代理配置 MCP 服务器和规则。使用 `--cursor`、`--claude` 或 `--opencode` 以针对特定代理。
</details>
**[其他 IDE 和客户端 →](https://context7.com/docs/resources/all-clients)**
<details>
<summary><b>OAuth 身份验证</b></summary>
Context7 MCP 服务器支持 OAuth 2.0 身份验证，适用于实现 [MCP OAuth 规范](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 的 MCP 客户端。
要使用 OAuth，请在客户端配置中将端点从 `/mcp` 更改为 `/mcp/oauth`:
```diff
- "url": "https://mcp.context7.com/mcp"
+ "url": "https://mcp.context7.com/mcp/oauth"
```
OAuth 仅适用于远程 HTTP 连接。对于使用 stdio 传输的本地 MCP 连接，请改用 API 密钥身份验证。
</details>
## 重要提示
### 添加规则
为了避免在每个提示中输入 `use context7`，请在您的 MCP 客户端中添加规则以自动调用 Context7 进行代码相关问题：
- **Cursor**：`Cursor 设置 > 规则`
- **Claude Code**：`CLAUDE.md`
- 或您的 MCP 客户端中的等效设置
**示例规则：
```txt
始终在需要库/API 文档、代码生成、设置或配置步骤时使用 Context7 MCP，而无需我明确要求。
```
### 使用库 ID
如果您已经知道要使用的库的确切名称，请将其 Context7 ID 添加到您的提示中。这样，Context7 MCP 服务器可以跳过库匹配步骤，直接继续检索文档。
```txt
使用 Supabase 实现基本身份验证。使用库 /supabase/supabase 获取 API 和文档。
```
斜杠语法告诉 MCP 工具为哪个库加载文档。
### 指定版本
要获取特定库版本的文档，只需在提示中提及版本：
```txt
如何设置 Next.js 14 中间件？使用 context7
```
Context7 将自动匹配适当的版本。
## 可用工具
Context7 MCP 提供以下工具供 LLM 使用：
- `resolve-library-id`：将通用库名称解析为 Context7 兼容的库 ID。
- `query`（必填）：用户的提问或任务（用于按相关性排序结果）
- `libraryName`（必填）：要搜索的库名称
- `query-docs`：使用 Context7 兼容的库 ID 检索库的文档。
- `libraryId`（必填）：确切的 Context7 兼容库 ID（例如，`/mongodb/docs`，`/vercel/next.js`）
- `query`（必填）：要获取相关文档的提问或任务
## 更多文档
- [更多 MCP 客户端](https://context7.com/docs/resources/all-clients) - 30 多个客户端的安装
- [添加库](https://context7.com/docs/adding-libraries) - 将您的库提交到 Context7
- [故障排除](https://context7.com/docs/resources/troubleshooting) - 常见问题和解决方案
- [API 参考](https://context7.com/docs/api-guide) - REST API 文档
- [开发者指南](https://context7.com/docs/resources/developer) - 在本地运行 Context7 MCP
## 免责声明
1. Context7 项目由社区贡献，虽然我们努力保持高质量，但我们不能保证所有库文档的准确性、完整性或安全性。Context7 中列出的项目由其各自所有者开发和维护，而不是由 Context7。如果您遇到任何可疑、不适当或可能有害的内容，请使用项目页面上的“报告”按钮立即通知我们。我们认真对待所有报告，并将及时审查标记的内容以维护我们平台的完整性和安全性。使用 Context7 时，您承认您自愿并承担风险。
2. 此仓库托管 MCP 服务器的源代码。支持组件 - API 后端、解析引擎和爬取引擎 - 是私有的，不属于此仓库。
## 🤝 与我们联系
通过以下方式保持更新并加入我们的社区：
- 📢 在 [X](https://x.com/context7ai) 上关注我们以获取最新新闻和更新
- 🌐 访问我们的 [官网](https://context7.com)
- 💬 加入我们的 [Discord 社区](https://upstash.com/discord)
## 📺 Context7 在媒体中
- [Better Stack： “免费工具使 Cursor 智能 10 倍”](https://youtu.be/52FC3qObp9E)
- [Cole Medin： “这是 AI 编码助手最好的 MCP 服务器”](https://www.youtube.com/watch?v=G7gK8H6u7Rs)
- [Income Stream Surfers： “Context7 + SequentialThinking MCPs：这是 AGI 吗？”](https://www.youtube.com/watch?v=-ggvzyLpK6o)
- [Julian Goldie SEO： “Context7：新的 MCP AI 代理更新”](https://www.youtube.com/watch?v=CTZm6fBYisc)
- [JeredBlu： “Context 7 MCP：获取文档即时 + VS Code 设置”](https://www.youtube.com/watch?v=-ls0D-rtET4)
- [Income Stream Surfers： “Context7：改变 AI 编码的新 MCP 服务器”](https://www.youtube.com/watch?v=PS-2Azb-C3M)
- [AICodeKing： “Context7 + Cline & RooCode：这个 MCP 服务器使 CLINE 效率提高 100 倍！”](https://www.youtube.com/watch?v=qZfENAPMnyo)
- [Sean Kochel： “5 个 MCP 服务器用于 Vibe Coding Glory（只需插入并使用）”](https://www.youtube.com/watch?v=LqTQi8qexJM)
## ⭐ 星级历史
[](https://www.star-history.com/#upstash/context7&Date)
## 📄 许可证
MIT
