[](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)
[](../README.md) [](./README.zh-TW.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.uk.md) [](./README.tr.md) [](./README.ar.md) [](./README.vi.md)
## ❌ 不使用Context7
大语言模型（LLM）依赖过时或通用的库信息。你会遇到：
- ❌ 代码示例已过时，基于一年前的训练数据
- ❌ 幻觉产生的API根本不存在
- ❌ 针对旧版本包的通用回答
## ✅ 使用Context7
Context7 MCP直接从源头获取最新的、特定版本的文档和代码示例——并将它们直接放入你的提示词中。
在你的提示词中附上`用context7`（或[设置规则](#添加规则)自动调用）：
```txt
创建一个Next.js中间件，检查cookies中的有效JWT，
并将未认证用户重定向到 `/login`。用context7
```
```txt
配置Cloudflare Worker脚本，将JSON API响应
缓存五分钟。用context7
```
Context7将最新的代码示例和文档直接获取到你的LLM上下文中。无需切换标签页，不会因幻觉产生不存在的API，不会生成过时的代码。
## 安装
> [!NOTE]
> **推荐使用API密钥**：在[context7.com/dashboard](https://context7.com/dashboard)s获取免费API密钥，使用秘钥后速率限制更高。
<details>
<summary><b>在Cursor中安装</b></summary>
前往：`Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`
推荐将以下配置粘贴到你的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": "YOUR_API_KEY"
}
}
}
}
```
#### Cursor本地服务器连接
[](https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)
```json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
}
}
```
</details>
<details>
<summary><b>在Claude Code中安装</b></summary>
运行以下命令。更多信息请参见[Claude Code MCP文档](https://code.claude.com/docs/zh-CN/mcp)。
#### Claude Code本地服务器连接
```sh
claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
```
#### Claude Code远程服务器连接
```sh
claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp
```
</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": "YOUR_API_KEY"
},
"enabled": true
}
}
```
#### Opencode本地服务器连接
```json
{
"mcp": {
"context7": {
"type": "local",
"command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
"enabled": true
}
}
}
```
</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>
## 重点技巧
### 添加规则
为避免每次都在提示词中输入`用context7`，你可以在MCP客户端中添加规则，自动为代码相关问题调用 Context7：
- **Cursor**：`Cursor Settings > Rules`
- **Claude Code**：`CLAUDE.md`
- 或你的 MCP 客户端中的等效设置
**规则示例：**
```txt
无需我明确要求，当我需要库或API文档、生成代码、创建项目基架时或配置步骤时，始终使用Context7 MCP。
```
### 使用库 ID
如果你已经确切知道要使用哪个库，请将其Context7 ID添加到你的提示词中。这样，Context7 MCP服务器可以跳过库匹配步骤，直接检索文档。
```txt
使用Supabase实现基本身份验证。用/supabase/supabase作为库ID获取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开发和维护。如果你遇到任何可疑、不当或潜在有害的内容，请使用项目页面上的“Report”按钮立即通知我们。我们认真对待所有举报，并将及时审查被举报的内容，以维护我们平台的完整性和安全性。使用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 MCP：这是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服务器（即插即用）"](https://www.youtube.com/watch?v=LqTQi8qexJM)
## ⭐ Star 历史
[](https://www.star-history.com/#upstash/context7&Date)
## 📄 许可证
MIT
