Context7 MCP：为 AI 助手提供实时代码文档的开源工具

本文介绍 Context7 MCP，一个为 AI 编程助手提供实时、版本特定代码文档的开源 MCP 服务器。该项目在 GitHub 上已获得 46.5k+ stars，帮助开发者解决 LLM 使用过时文档和产生 API 幻觉的问题。

项目简介

Context7 MCP 是由 Upstash 团队开发的开源项目，旨在解决 LLM（大语言模型）在编程辅助时面临的文档过时问题。传统的 LLM 训练数据有截止日期，导致它们对最新版本的库和框架了解有限，经常产生不存在的 API 调用或已过时的代码示例。

Context7 通过 MCP（Model Context Protocol）协议，将最新的、版本特定的文档和代码示例直接注入到 AI 助手的上下文中，让 AI 能够基于准确的最新信息回答问题。

核心特性

实时文档获取：从源代码直接拉取最新的文档和代码示例
版本感知：支持指定特定版本的库文档（如 Next.js 14、React 18 等）
多客户端支持：支持 Cursor、Claude Code、VS Code、Opencode 等 30+ 个 MCP 客户端
丰富的库支持：涵盖 React、Next.js、Vue、Supabase、MongoDB 等数千个流行库
简单集成：通过 use context7 提示词即可触发文档查询
OAuth 支持：支持 OAuth 2.0 认证，便于团队协作

技术栈

TypeScript：主要开发语言（占比 87.9%）
JavaScript：辅助脚本（占比 11.7%）
Docker：容器化部署支持
MCP 协议：基于 Model Context Protocol 标准

安装指南

在 Cursor 中安装

打开 Cursor 设置：Settings -> Cursor Settings -> MCP
点击 Add new global MCP server
添加以下配置：

json

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

或使用一键安装按钮：

在 Claude Code 中安装

运行以下命令：

bash

# 本地服务器连接
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

# 远程服务器连接
claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

使用 ctx7 CLI 安装

bash

npx ctx7 setup

该命令会通过 OAuth 认证，自动生成 API key 并配置 MCP 服务器。

获取 API Key

访问 context7.com/dashboard 获取免费的 API key，以获得更高的请求速率限制。

快速开始

安装完成后，在你的提示词中添加 use context7：

text

Create a Next.js middleware that checks for a valid JWT in cookies
and redirects unauthenticated users to `/login`. use context7

text

Configure a Cloudflare Worker script to cache
JSON API responses for five minutes. use context7

Context7 会自动获取相关的最新文档和代码示例，注入到你的对话上下文中。

使用示例

场景 1：指定特定库

如果你知道具体要使用哪个库，可以使用库 ID 格式：

Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.

场景 2：指定版本

需要特定版本的文档时，直接在提示词中说明版本：

How do I set up Next.js 14 middleware? use context7

场景 3：自动触发规则

为避免每次手动输入 use context7，可以在 MCP 客户端添加规则：

Cursor：Cursor Settings > Rules

Claude Code：在 CLAUDE.md 中添加：

Always use Context7 MCP when I need library/API documentation, code generation, setup or configuration steps without me having to explicitly ask.

API 参考

Context7 MCP 提供以下工具：

resolve-library-id

将通用库名称解析为 Context7 兼容的库 ID。

参数	类型	必填	说明
query	string	是	用户的问题或任务（用于相关性排序）
libraryName	string	是	要搜索的库名称

query-docs

使用 Context7 兼容的库 ID 检索文档。

参数	类型	必填	说明
libraryId	string	是	精确的 Context7 库 ID（如 `/mongodb/docs`、`/vercel/next.js`）
query	string	是	要获取相关文档的问题或任务

注意事项

社区贡献：Context7 的项目文档由社区贡献，虽然团队努力维护高质量内容，但无法保证所有库文档的准确性、完整性或安全性。
私有组件：该仓库仅包含 MCP 服务器的源代码，API 后端、解析引擎和爬取引擎等支持组件是私有的，不包含在此仓库中。
使用限制：免费版有速率限制，如需更高配额请使用 API key。

社区与支持

X/Twitter：@context7ai
Discord：Upstash Discord
问题反馈：GitHub Issues

许可证

MIT License

字节笔记本