如何设置 Context7 MCP Server (2026)

如何设置 Context7 MCP 服务器 (2026)

如果你曾向 AI 编程助手询问某个框架，却收到了过时或幻觉生成的 API 建议，那么 Context7 就是你的解决方案。Context7 是一个模型上下文协议 (Model Context Protocol, MCP) 服务器，旨在为 AI 助手提供直接从官方来源提取的、针对特定版本的最新文档。Context7 不再依赖 LLM 的训练数据（这些数据可能已过时数月或数年），而是获取实际的实时文档并将其注入到 AI 的上下文中。

本指南将带你完成在常用 AI 编程工具中安装、配置和使用 Context7 的全过程。

什么是 MCP (Model Context Protocol)？

在深入了解 Context7 之前，了解什么是 MCP 会很有帮助。模型上下文协议是由 Anthropic 最初开发的一种开放标准，它允许 AI 助手通过标准化接口连接外部数据源和工具。可以将 MCP 服务器视为插件，赋予 AI 模型访问现实世界信息和执行功能的能力。

一个 MCP 服务器可以提供：

资源 (Resources)： AI 可以读取的数据（文件、文档、数据库 schema）
工具 (Tools)： AI 可以调用的函数（搜索、API 请求、代码执行）
提示词 (Prompts)： 针对常见任务预构建的提示词模板

Context7 的作用是什么？

Context7 是一个专门向 AI 编程助手提供准确、最新的库和框架文档的 MCP 服务器。当你向 AI 助手询问特定库时，Context7 会：

识别你询问的库
从其索引中获取当前文档
将相关文档作为上下文提供给 AI 模型
随后 AI 根据实际的、当前的文档生成回答

这消出了 AI 编程助手最常见的问题：过时或虚假的 API 细节。

支持的库

Context7 维护了数千个热门库的文档索引，包括：

React, Next.js, Vue, Svelte, Angular
Node.js, Express, Fastify, Hono
Python (Django, Flask, FastAPI, SQLAlchemy)
TypeScript, Zod, Prisma, Drizzle
Tailwind CSS, shadcn/ui
Rust, Go, Java 等等

安装方法

Context7 可以作为多种 AI 编程工具的 MCP 服务器进行安装。以下是最常见的设置方式。

方法 1：Claude Code (推荐)

Claude Code 原生支持 MCP。只需一条命令即可添加 Context7：

claude mcp add context7 -- npx -y @context7/mcp@latest

大功告成。现在 Claude Code 在每次对话中都可以访问 Context7 文档。

验证是否生效：

claude mcp list

你应该能看到 context7 被列为已启用的 MCP 服务器。

方法 2：Cursor

对于 Cursor，你需要将 Context7 添加到 MCP 配置文件中。在项目根目录下创建或编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

重启 Cursor 后，Context7 即可在 AI 聊天面板中使用。

方法 3：支持 MCP 的 VS Code Copilot

对于支持 MCP 的 VS Code GitHub Copilot，将其添加到你的 .vscode/mcp.json：

{
  "servers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

方法 4：Windsurf

添加到你的 Windsurf MCP 配置文件 (~/.windsurf/mcp.json)：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

方法 5：手动 / 独立运行

如果你想将 Context7 作为独立服务器运行以进行自定义集成：

# 全局安装
npm install -g @context7/mcp

# 运行服务器
context7-mcp

# 或直接通过 npx 运行
npx @context7/mcp@latest

服务器默认遵循 MCP 规范，通过 stdio 进行通信。

前置条件

在安装 Context7 之前，请确保你拥有：

要求	最低版本	检查命令
Node.js	18.0+	`node --version`
npm	9.0+	`npm --version`
npx	随 npm 附带	`npx --version`

如果你尚未安装 Node.js：

# macOS (使用 Homebrew)
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Windows (使用 winget)
winget install OpenJS.NodeJS

如何高效使用 Context7

Context7 安装后，在大多数设置中都会自动运行。不过，通过在提示词中更加明确，你可以获得更好的效果。

基础用法

只需在提示词中提到某个库，Context7 就会提供相关文档：

如何在 Next.js 15 中设置 server actions？

Context7 会检测到 "Next.js 15" 并提供当前的 Server Actions 文档。

显式触发 Context7

为了获得更可靠的结果，可以在提示词中使用 use context7 短语：

use context7 - 如何在 Hono 中配置中间件？

指定库版本

你可以请求特定版本的文档：

use context7 - 向我展示如何使用 React 19 新的 `use` hook

比较不同方案

当你需要比较不同版本或框架的工作方式时，Context7 特别有用：

use context7 - Drizzle ORM 和 Prisma 在定义关联 (relations) 方面有什么区别？展示两种方式的代码。

配置选项

Context7 可以通过环境变量进行配置：

变量	描述	默认值
`CONTEXT7_CACHE_DIR`	文档缓存目录	`~/.context7/cache`
`CONTEXT7_CACHE_TTL`	缓存生存时间 (秒)	`3600` (1 小时)
`CONTEXT7_MAX_TOKENS`	注入上下文的最大 Token 数	`10000`
`CONTEXT7_LOG_LEVEL`	日志详细级别 (debug, info, warn, error)	`info`

要在 MCP 配置中设置这些变量：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"],
      "env": {
        "CONTEXT7_MAX_TOKENS": "15000",
        "CONTEXT7_CACHE_TTL": "7200"
      }
    }
  }
}

故障排除

Context7 未提供文档

检查服务器是否运行： 在 Claude Code 中运行 claude mcp list。在 Cursor 中检查底部状态栏的 MCP 状态。
显式指定： 在提示词中使用 "use context7" 强制触发工具。
检查 Node.js 版本： Context7 需要 Node.js 18+。

响应速度慢

Context7 会在首次获取后将文档缓存在本地。如果第一次查询较慢，后续对同一个库的查询应该会很快。你可以增加缓存 TTL 来减少重新获取的次数：

CONTEXT7_CACHE_TTL=86400  # 缓存 24 小时

npx 安装失败

如果 npx 失败，请尝试全局安装该包：

npm install -g @context7/mcp@latest

然后更新你的 MCP 配置以使用全局二进制文件：

{
  "mcpServers": {
    "context7": {
      "command": "context7-mcp"
    }
  }
}

Context7 与其他文档 MCP 服务器对比

特性	Context7	Docs MCP	DevDocs MCP
库覆盖量	5,000+	500+	1,000+
版本特定文档	是	部分支持	否
自动检测	是	否	否
缓存机制	是	是	否
更新频率	每日	每周	每月
设置复杂度	一条命令	中等	中等

结语

Context7 是你可以添加到 AI 编程环境中最能立即见效的 MCP 服务器之一。它通过一行安装命令，解决了 AI 编程助手最大的可靠性问题——文档过时。无论你使用 Claude Code、Cursor、VS Code 还是其他兼容 MCP 的工具，Context7 都值得加入到你的工作流中。

对于在编写代码之余也处理视觉和媒体内容的开发者，Hypereal AI 提供了 AI 图像生成、视频创作和数字人构建的 API 访问。将 Context7 的精准编程辅助与 Hypereal AI 的媒体生成能力结合使用吧。

如何设置 Context7 MCP 服务器 (2026)

本指南将带你完成在常用 AI 编程工具中安装、配置和使用 Context7 的全过程。

什么是 MCP (Model Context Protocol)？

一个 MCP 服务器可以提供：

资源 (Resources)： AI 可以读取的数据（文件、文档、数据库 schema）
工具 (Tools)： AI 可以调用的函数（搜索、API 请求、代码执行）
提示词 (Prompts)： 针对常见任务预构建的提示词模板

Context7 的作用是什么？

Context7 是一个专门向 AI 编程助手提供准确、最新的库和框架文档的 MCP 服务器。当你向 AI 助手询问特定库时，Context7 会：

识别你询问的库
从其索引中获取当前文档
将相关文档作为上下文提供给 AI 模型
随后 AI 根据实际的、当前的文档生成回答

这消出了 AI 编程助手最常见的问题：过时或虚假的 API 细节。

支持的库

Context7 维护了数千个热门库的文档索引，包括：

React, Next.js, Vue, Svelte, Angular
Node.js, Express, Fastify, Hono
Python (Django, Flask, FastAPI, SQLAlchemy)
TypeScript, Zod, Prisma, Drizzle
Tailwind CSS, shadcn/ui
Rust, Go, Java 等等

安装方法

Context7 可以作为多种 AI 编程工具的 MCP 服务器进行安装。以下是最常见的设置方式。

方法 1：Claude Code (推荐)

Claude Code 原生支持 MCP。只需一条命令即可添加 Context7：

claude mcp add context7 -- npx -y @context7/mcp@latest

大功告成。现在 Claude Code 在每次对话中都可以访问 Context7 文档。

验证是否生效：

claude mcp list

你应该能看到 context7 被列为已启用的 MCP 服务器。

方法 2：Cursor

对于 Cursor，你需要将 Context7 添加到 MCP 配置文件中。在项目根目录下创建或编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

重启 Cursor 后，Context7 即可在 AI 聊天面板中使用。

方法 3：支持 MCP 的 VS Code Copilot

对于支持 MCP 的 VS Code GitHub Copilot，将其添加到你的 .vscode/mcp.json：

{
  "servers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

方法 4：Windsurf

添加到你的 Windsurf MCP 配置文件 (~/.windsurf/mcp.json)：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"]
    }
  }
}

方法 5：手动 / 独立运行

如果你想将 Context7 作为独立服务器运行以进行自定义集成：

# 全局安装
npm install -g @context7/mcp

# 运行服务器
context7-mcp

# 或直接通过 npx 运行
npx @context7/mcp@latest

服务器默认遵循 MCP 规范，通过 stdio 进行通信。

前置条件

在安装 Context7 之前，请确保你拥有：

要求	最低版本	检查命令
Node.js	18.0+	`node --version`
npm	9.0+	`npm --version`
npx	随 npm 附带	`npx --version`

如果你尚未安装 Node.js：

# macOS (使用 Homebrew)
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Windows (使用 winget)
winget install OpenJS.NodeJS

如何高效使用 Context7

Context7 安装后，在大多数设置中都会自动运行。不过，通过在提示词中更加明确，你可以获得更好的效果。

基础用法

只需在提示词中提到某个库，Context7 就会提供相关文档：

如何在 Next.js 15 中设置 server actions？

Context7 会检测到 "Next.js 15" 并提供当前的 Server Actions 文档。

显式触发 Context7

为了获得更可靠的结果，可以在提示词中使用 use context7 短语：

use context7 - 如何在 Hono 中配置中间件？

指定库版本

你可以请求特定版本的文档：

use context7 - 向我展示如何使用 React 19 新的 `use` hook

比较不同方案

当你需要比较不同版本或框架的工作方式时，Context7 特别有用：

use context7 - Drizzle ORM 和 Prisma 在定义关联 (relations) 方面有什么区别？展示两种方式的代码。

配置选项

Context7 可以通过环境变量进行配置：

变量	描述	默认值
`CONTEXT7_CACHE_DIR`	文档缓存目录	`~/.context7/cache`
`CONTEXT7_CACHE_TTL`	缓存生存时间 (秒)	`3600` (1 小时)
`CONTEXT7_MAX_TOKENS`	注入上下文的最大 Token 数	`10000`
`CONTEXT7_LOG_LEVEL`	日志详细级别 (debug, info, warn, error)	`info`

要在 MCP 配置中设置这些变量：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp@latest"],
      "env": {
        "CONTEXT7_MAX_TOKENS": "15000",
        "CONTEXT7_CACHE_TTL": "7200"
      }
    }
  }
}

故障排除

Context7 未提供文档

检查服务器是否运行： 在 Claude Code 中运行 claude mcp list。在 Cursor 中检查底部状态栏的 MCP 状态。
显式指定： 在提示词中使用 "use context7" 强制触发工具。
检查 Node.js 版本： Context7 需要 Node.js 18+。

响应速度慢

Context7 会在首次获取后将文档缓存在本地。如果第一次查询较慢，后续对同一个库的查询应该会很快。你可以增加缓存 TTL 来减少重新获取的次数：

CONTEXT7_CACHE_TTL=86400  # 缓存 24 小时

npx 安装失败

如果 npx 失败，请尝试全局安装该包：

npm install -g @context7/mcp@latest

然后更新你的 MCP 配置以使用全局二进制文件：

{
  "mcpServers": {
    "context7": {
      "command": "context7-mcp"
    }
  }
}

Context7 与其他文档 MCP 服务器对比

特性	Context7	Docs MCP	DevDocs MCP
库覆盖量	5,000+	500+	1,000+
版本特定文档	是	部分支持	否
自动检测	是	否	否
缓存机制	是	是	否
更新频率	每日	每周	每月
设置复杂度	一条命令	中等	中等

开始使用 Hypereal 构建

如何设置 Context7 MCP 服务器 (2026)

什么是 MCP (Model Context Protocol)？

Context7 的作用是什么？

支持的库

安装方法

方法 1：Claude Code (推荐)

方法 2：Cursor

方法 3：支持 MCP 的 VS Code Copilot

方法 4：Windsurf

方法 5：手动 / 独立运行

前置条件

如何高效使用 Context7

基础用法

显式触发 Context7

指定库版本

比较不同方案

配置选项

故障排除

Context7 未提供文档

响应速度慢

npx 安装失败

Context7 与其他文档 MCP 服务器对比

结语

相关文章

如何从零开始构建 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

如何在 IntelliJ IDEs 中使用 MCP (2026)

立即开始构建

开始使用 Hypereal 构建

如何设置 Context7 MCP 服务器 (2026)

什么是 MCP (Model Context Protocol)？

Context7 的作用是什么？

支持的库

安装方法

方法 1：Claude Code (推荐)

方法 2：Cursor

方法 3：支持 MCP 的 VS Code Copilot

方法 4：Windsurf

方法 5：手动 / 独立运行

前置条件

如何高效使用 Context7

基础用法

显式触发 Context7

指定库版本

比较不同方案

配置选项

故障排除

Context7 未提供文档

响应速度慢

npx 安装失败

Context7 与其他文档 MCP 服务器对比

结语

相关文章

如何从零开始构建 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

如何在 IntelliJ IDEs 中使用 MCP (2026)

立即开始构建