Context7 MCP

你是否曾经遇到过这样的情况：让AI根据最新版本的React或Next.js生成代码，结果它却用了已经废弃的API？或者它虚构了一个根本不存在的函数？这是因为大语言模型的训练数据有截止日期，无法自动获取最新的文档。今天要介绍的开源项目Context7 MCP，正是为了解决这个痛点而设计的。它直接从源代码获取特定版本的文档，确保AI生成的内容是最新且准确的。

项目基本信息

一、项目介绍

Context7 MCP是由Upstash团队开发的MCP服务器，旨在解决大语言模型依赖过时训练数据的根本问题。传统的LLM只能基于训练时的知识回答问题，这意味着对于发布不到一年的新库、新版本或新API，LLM要么不知道，要么会给出错误的答案。

Context7的工作原理是：当你向AI提问时，可以通过“use context7”这个关键词（或设置自动规则），Context7会直接从源代码中获取最新的、特定版本的文档和代码示例，并将它们注入到LLM的上下文中。这样，AI就能基于最新文档回答问题，避免过时代码、虚构API和旧版本包的通用答案。

Context7提供了两种使用方式：

• 远程服务器：通过HTTPS连接到https://mcp.context7.com/mcp，无需本地安装
• 本地服务器：通过npx运行本地版本

二、核心优势

最新文档保证

直接从源代码提取特定版本的文档，确保内容是最新且准确的，解决了LLM训练数据过时的问题。

多种使用方式

支持远程HTTP连接和本地stdio连接两种模式，适应不同场景和偏好。

OAuth 2.0认证

远程服务器支持OAuth 2.0认证，符合MCP OAuth规范，更加安全。

智能库解析

提供resolve-library-id工具，可以将通用的库名称（如“React”）解析为Context7兼容的库ID（如/vercel/next.js）。

版本自动匹配

只需在提示中提及版本（如“Next.js 14”），Context7会自动匹配适当的文档版本。

广泛客户端支持

支持Cursor、Claude Code、Opencode等多种MCP客户端。

三、适用场景

日常开发编码

当你需要根据最新版本的库编写代码时，Context7能确保AI使用正确的API。

学习新技术

当你学习一个新的框架或库时，Context7可以让AI基于官方最新文档回答问题。

代码迁移和升级

当你要将项目从旧版本升级到新版本时，Context7可以提供新版本的API变更信息。

CI/CD集成

可以在自动化流程中集成Context7，确保生成的代码始终使用最新文档。

四、安装教程

系统要求

安装步骤

Context7 MCP提供了远程和本地两种连接方式。

方式一：远程HTTP连接（推荐）

这种方式无需本地安装，配置最简单。

对于Cursor：

1. 打开Cursor设置：设置 -> Cursor设置 -> MCP
2. 添加新的全局MCP服务器，或编辑~/.cursor/mcp.json文件：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "你的API密钥"
      }
    }
  }
}

对于Claude Code：

claude mcp add --header "CONTEXT7_API_KEY: 你的API密钥" --transport http context7 https://mcp.context7.com/mcp

对于Opencode：

在配置文件中添加：

{
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "你的API密钥"
      },
      "enabled": true
    }
  }
}

方式二：本地stdio连接

对于Cursor：

在~/.cursor/mcp.json中添加：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "你的API密钥"]
    }
  }
}

对于Claude Code：

claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key 你的API密钥

获取API密钥（可选但推荐）

访问 https://context7.com/dashboard 免费获取API密钥，可以获得更高的速率限制。

添加规则（重要）

为避免在每个提示中手动输入“use context7”，建议在MCP客户端中添加自动规则：

Cursor：Cursor设置 -> 规则，添加：

当我需要库/API文档、代码生成、设置或配置步骤时，始终使用Context7 MCP。

Claude Code：在项目根目录的CLAUDE.md文件中添加类似规则。

五、使用示例

配置完成后，你就可以在MCP客户端中使用Context7了。

示例1：基本使用（手动触发）

用户指令：

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

Context7会自动获取Next.js最新文档，AI基于这些文档生成代码。

示例2：指定库ID

如果你确切知道要使用哪个库，可以指定库ID：

用户指令：

使用Supabase实现基本认证。use library /supabase/supabase for API and docs.

斜杠语法告诉Context7精确加载哪个库的文档。

示例3：指定版本

用户指令：

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

Context7会自动匹配Next.js 14的文档版本。

示例4：查询特定库的文档

用户指令：

使用Context7查询Tailwind CSS v4的配置方法

Context7会调用resolve-library-id和query-docs工具，返回Tailwind CSS v4的最新文档。

示例5：使用OAuth认证（远程模式）

如果MCP客户端支持OAuth，可以将端点从/mcp改为/mcp/oauth：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp/oauth"
    }
  }
}

客户端会自动引导你完成OAuth授权流程。

六、常见问题

问题1：Context7和普通搜索有什么区别？

解决方案：普通搜索只能找到网页内容，而Context7直接从源代码提取文档，确保是官方最新版本，并且结构化程度更高。

问题2：需要API密钥吗？

解决方案：不需要也可以使用，但免费API密钥可以获得更高的速率限制。从context7.com/dashboard免费获取。

问题3：支持哪些库？

解决方案：Context7支持大量主流库和框架。如果不确定，可以使用resolve-library-id工具查询。

问题4：在Cursor中配置后不生效

解决方案：

• 确认配置文件路径正确（~/.cursor/mcp.json）
• 检查JSON格式是否正确
• 重启Cursor

问题5：远程模式和本地模式哪个更好？

解决方案：

• 远程模式：无需安装，配置简单，适合大多数用户
• 本地模式：响应可能更快，适合需要完全本地运行的环境

七、总结

Context7 MCP是MCP生态中一个极其实用的工具。它解决了AI编程中一个普遍且令人头疼的问题：LLM的知识截止日期导致无法获取最新文档。通过Context7，你的AI助手可以随时访问最新的库文档和代码示例。

这个项目的最大价值在于：

1. 准确性：消除AI生成过时代码或虚构API的问题
2. 实时性：直接从源代码获取最新文档，没有延迟
3. 易用性：只需在提示中加上use context7，或设置自动规则
4. 广泛支持：支持Cursor、Claude Code、Opencode等多种客户端
5. 灵活部署：支持远程和本地两种模式

如果你经常使用AI编程工具，并且希望生成的代码始终基于最新文档，Context7 MCP绝对是你必须安装的工具。 它让“AI写出的代码立刻就能用”成为了现实。