Context7

Context7 技能

实时文档检索服务，解决LLM训练数据过时问题。

核心能力

使用方式

用户：Next.js 14中间件怎么用？
→ 自动调用：resolve-library-id("next.js") → query-docs("中间件配置")

配置

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

官方资源

• 官网：https://context7.com
• GitHub：https://github.com/upstash/context7

Context7 MCP 技能

功能说明

Context7 MCP Server 是由 Upstash 开发的实时文档检索服务：

• 📚 实时文档：获取最新的库文档和代码示例
• 🎯 版本特定：支持指定版本的文档检索
• 🔍 语义匹配：自动识别相关库和文档
• 💡 代码示例：直接获取可运行的代码片段
• 🌐 多语言支持：支持主流编程语言和框架

核心问题解决

❌ 没有Context7时

• 代码示例基于过时的训练数据
• 幻觉出不存在的API
• 使用旧版本的最佳实践

✅ 使用Context7后

• 获取最新版本文档
• 准确的API调用方式
• 版本特定的代码示例

工具列表

1. resolve-library-id - 库ID解析

功能：将库名称解析为Context7兼容的库ID

参数说明：

使用示例：

{
  "query": "如何设置Next.js中间件",
  "libraryName": "next.js"
}

返回：Context7库ID（如 /vercel/next.js）

2. query-docs - 文档查询

功能：使用库ID获取相关文档

参数说明：

使用示例：

{
  "libraryId": "/vercel/next.js",
  "query": "如何配置中间件进行JWT验证"
}

返回：

• 相关文档片段
• 代码示例
• API说明

配置方式

方式一：远程服务器（推荐）

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

方式二：本地服务器

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

方式三：Claude Code 安装

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

使用场景

1. 获取最新库文档

用户：如何使用Next.js 14的App Router？
助手：[在提示中添加 "use context7"]
[Context7自动获取Next.js 14的最新文档]

2. 代码生成支持

用户：写一个使用Supabase认证的示例
助手：[提示中添加 "use library /supabase/supabase"]
[直接获取Supabase认证文档]

3. 版本迁移

用户：从Next.js 13迁移到14有哪些变化？
助手：[指定版本查询]
[获取版本迁移指南]

4. API参考查询

用户：MongoDB的聚合管道怎么用？
助手：[调用 resolve-library-id → query-docs]
[获取聚合管道文档]

使用方法

方法一：提示中声明

在提示中添加 use context7：

创建一个Next.js中间件，检查JWT有效性。use context7

方法二：指定库ID

如果已知库ID，直接指定：

使用Supabase实现基础认证。use library /supabase/supabase

方法三：指定版本

提及特定版本号：

如何设置Next.js 14中间件？use context7

自动触发规则

建议在MCP客户端中添加规则自动调用：

当我需要库/API文档、代码生成、配置步骤时，自动使用Context7 MCP，无需我明确要求。

设置位置：

• Cursor: Settings > Rules
• Claude Code: CLAUDE.md

触发时机

• 需要查询库文档
• 生成代码需要API参考
• 学习新技术栈
• 版本迁移和升级
• 最佳实践查询

最佳实践

1. 明确指定库

# 好的做法
"使用React hooks实现状态管理。use library /facebook/react"

# 不够明确
"用React实现状态管理"  # 可能匹配到多个库

2. 结合版本信息

# 指定版本
"Next.js 14的App Router配置。use context7"

# 自动匹配最新版
"Next.js的App Router配置。use context7"

3. 分步查询

# 1. 先解析库ID
library_id = resolve_library_id("Tailwind CSS")

# 2. 再查询具体问题
docs = query_docs(library_id, "如何配置自定义颜色")

注意事项

⚠️ 重要提示：

1. 获取API Key可获得更高速率限制
2. 文档由社区贡献，以官方文档为准
3. 库ID使用斜杠格式（如 /vercel/next.js）
4. 支持OAuth认证（远程连接）

支持的客户端

Context7支持30+ MCP客户端：

• ✅ Cursor
• ✅ Claude Code
• ✅ VS Code
• ✅ Opencode
• ✅ Cherry Studio
• ✅ Continue
• ...更多

官方资源

• 官网: https://context7.com
• GitHub: https://github.com/upstash/context7
• API文档: https://context7.com/docs/api-guide
• 客户端列表: https://context7.com/docs/resources/all-clients
• 许可证: MIT License

常见问题

Q: 免费使用有限制吗？

A: 免费使用有速率限制，建议获取API Key

Q: 支持哪些库？

A: 支持主流编程语言和框架，可通过resolve-library-id搜索

Q: 如何添加新库？

A: 访问 context7.com/docs/adding-libraries 提交

Q: 文档多久更新？

A: 实时跟踪官方文档更新

与其他工具配合

开发工作流

context7（查文档）→ 编写代码 → 测试调试

学习新技术

context7 → deepwiki（背景知识）→ 实践

更新时间: 2026-03-08 版本: 1.0