README.zh-CN.md

Context7 MCP - 最新文档赋能每个提示词

❌ 不使用Context7

大语言模型（LLM）依赖过时或通用的库信息。你会遇到：

• ❌ 代码示例已过时，基于一年前的训练数据
• ❌ 幻觉产生的API根本不存在
• ❌ 针对旧版本包的通用回答

✅ 使用Context7

Context7 MCP直接从源头获取最新的、特定版本的文档和代码示例——并将它们直接放入你的提示词中。

在你的提示词中附上用context7（或设置规则自动调用）：

创建一个Next.js中间件，检查cookies中的有效JWT，
并将未认证用户重定向到 `/login`。用context7

配置Cloudflare Worker脚本，将JSON API响应
缓存五分钟。用context7

Context7将最新的代码示例和文档直接获取到你的LLM上下文中。无需切换标签页，不会因幻觉产生不存在的API，不会生成过时的代码。

安装

Note

推荐使用API密钥：在context7.com/dashboards获取免费API密钥，使用秘钥后速率限制更高。

在Cursor中安装

前往：Settings -> Cursor Settings -> MCP -> Add new global MCP server

推荐将以下配置粘贴到你的Cursor ~/.cursor/mcp.json 文件中。你也可以通过在项目文件夹中创建 .cursor/mcp.json 在特定项目中安装。更多信息请参阅 Cursor MCP 文档。

自Cursor 1.0起，你可以点击下面的安装按钮一键安装。

Cursor远程服务器连接

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor本地服务器连接

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

在Claude Code中安装

运行以下命令。更多信息请参见Claude Code MCP文档。

Claude Code本地服务器连接

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Claude Code远程服务器连接

claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

在Opencode中安装

将此内容添加到你的Opencode配置文件中。更多信息请参见Opencode MCP 文档。

Opencode远程服务器连接

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "headers": {
      "CONTEXT7_API_KEY": "YOUR_API_KEY"
    },
    "enabled": true
  }
}

Opencode本地服务器连接

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "enabled": true
    }
  }
}

其他IDE和客户端 →

OAuth认证

Context7 MCP服务器支持OAuth 2.0认证，适用于实现了MCP OAuth规范的MCP客户端。

要使用OAuth，请在客户端配置中将端点从/mcp更改为/mcp/oauth：

- "url": "https://mcp.context7.com/mcp"
+ "url": "https://mcp.context7.com/mcp/oauth"

OAuth仅适用于远程HTTP连接。对于使用stdio传输的本地MCP连接，请改用API密钥认证。

重点技巧

添加规则

为避免每次都在提示词中输入用context7，你可以在MCP客户端中添加规则，自动为代码相关问题调用 Context7：

• Cursor：Cursor Settings > Rules
• Claude Code：CLAUDE.md
• 或你的 MCP 客户端中的等效设置

规则示例：

无需我明确要求，当我需要库或API文档、生成代码、创建项目基架时或配置步骤时，始终使用Context7 MCP。

使用库 ID

如果你已经确切知道要使用哪个库，请将其Context7 ID添加到你的提示词中。这样，Context7 MCP服务器可以跳过库匹配步骤，直接检索文档。

使用Supabase实现基本身份验证。用/supabase/supabase作为库ID获取API和文档。

斜杠语法明确告知MCP工具需加载文档的库。

指定版本

要获取特定库版本的文档，只需在提示词中提及版本：

如何设置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客户端 - 30+客户端的安装说明
• 添加库 - 将你的库提交到Context7
• 故障排除 - 常见问题和解决方案
• API参考 - REST API 文档
• 开发者指南 - 本地运行Context7 MCP

免责声明

1- Context7项目由社区贡献，虽然我们努力保持高质量，但我们不能保证所有库文档的准确性、完整性或安全性。Context7中列出的项目由其各自所有者开发和维护，而非由Context7开发和维护。如果你遇到任何可疑、不当或潜在有害的内容，请使用项目页面上的“Report”按钮立即通知我们。我们认真对待所有举报，并将及时审查被举报的内容，以维护我们平台的完整性和安全性。使用Context7即表示你承认自行承担风险。

2- 本仓库托管MCP服务器的源代码。支持组件——API 后端、解析引擎和爬取引擎——是私有的，不包含在本仓库中。

🤝 与我们联系

保持更新并加入我们的社区：

• 📢 在X上关注我们获取最新新闻和更新
• 🌐 访问我们的网站
• 💬 加入我们的Discord社区

📺 Context7媒体报道

• Better Stack："免费工具让Cursor智能10倍"
• Cole Medin："这绝对是AI编码助手的最佳MCP服务器"
• Income Stream Surfers："Context7 + SequentialThinking MCP：这是AGI吗？"
• Julian Goldie SEO："Context7：新的MCP AI代理更新"
• JeredBlu："Context 7 MCP：即时获取文档 + VS Code配置方法"
• Income Stream Surfers："Context7：将改变AI编码的新MCP服务器"
• AICodeKing："Context7 + Cline & RooCode：这个MCP服务器让CLINE效果提升100倍！"
• Sean Kochel："5个让编码更爽的MCP服务器（即插即用）"

⭐ Star 历史

📄 许可证

MIT