📘 MCP Context7

1.1 🎯 简介

Context7 是 Upstash 推出的一个 MCP 服务器，旨在解决 LLM 知识库过时和幻觉问题。它能为 AI 提供第三方库的最新、特定版本的官方文档和代码示例。

核心特性:

• 🔹 最新文档: 直接获取最新的库文档，不再受限于模型训练截止日期。
• 🔹 防幻觉: 注入真实的 API 签名和用法，防止 AI 瞎编代码。
• 🔹 自动调用: 支持配置规则，让 AI 在遇到编程问题时自动查询文档。

技术栈: TypeScript, Node.js, Express.js

1.2 💡 适用场景

1.2.1 ✅ 适合使用的场景

1. 使用新兴框架/库

   • 当你使用刚发布不久的库（如最新的 Next.js 版本，或刚出的 AI SDK）时，模型原本的训练数据里没有这些知识。

2. 版本迁移

   • 需要将代码从 v1 迁移到 v2，Context7 可以明确提供 v2 的 Breaking Changes 和新用法。

3. 减少代码调试

   • 让 AI 一次性写出正确的 API 调用，而不是反复试错。

1.2.2 ❌ 不适合使用的场景

• 极其冷门的私有库: 除非配置了 API Key 且 Context7 索引了该库。
• 不需要联网的基础语法: Python/JS 基础语法不需要查文档。

1.3 🔧 安装步骤

1.3.1 前置要求

• Node.js v18 或更高。

1.3.2 安装方法

通过 npx 运行 (推荐)

npx -y @upstash/context7-mcp

1.3.3 Claude Desktop 配置

在 claude_desktop_config.json 中添加配置：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp"
      ],
      "env": {
        "CONTEXT7_API_KEY": "可选，填入你的 key 以获得更高限额"
      }
    }
  }
}

1.3.4 验证安装

1. 重启 Claude。
2. 提问: "Use context7 to show me how to use the latest feature of Supabase".
3. 预期输出: Claude 调用工具查询 Supabase 文档，并给出基于最新文档的回答。

1.4 ⚠️ 常见错误与排查

1.4.1 错误1: 找不到库

症状: AI 提示找不到某个库的文档。

原因: 库名称拼写错误，或者 Context7 尚未收录该库。

解决方案:

1. 尝试使用更标准的包名 (如 use library /supabase/supabase-js).

1.5 ✨ 最佳实践

1.5.1 🎨 使用技巧

1. 显式调用

   • 在提示词中加入 "use context7" 或 "check documentation" 来强制 AI 查文档。

2. 指定库路径

   • 使用 use library /<vendor>/<library> 语法精准定位。

1.6 📌 P.S. 其他注意事项

这是一个 "RAG as a Service" 的工具，非常适合弥补大模型知识滞后的短板。