Claude Code教程（八）| MCP 之 Context7

[一、Context7 MCP 是什么](#一、Context7 MCP 是什么)
二、前置条件
三、接入方式
- 方式一：一键安装（推荐）
- [方式二：claude mcp add 命令行](#方式二：claude mcp add 命令行)
- 方式三：手动编辑配置文件
- [方式四：CLI + Skills（备选，不推荐）](#方式四：CLI + Skills（备选，不推荐）)
[四、Windows 注意事项](#四、Windows 注意事项)
五、验证
六、使用方式
七、各方式对比总结

一、Context7 MCP 是什么

Context7 是 Upstash 提供的 MCP（Model Context Protocol）服务，它在你需要查库/框架/API 文档时，自动拉取最新版本的官方文档和代码示例注入到对话上下文中，避免 LLM 基于过时训练数据给出错误答案。

接入后 Claude Code 获得两个原生工具：

工具	用途
`resolve-library-id`	用库名和问题搜索，返回匹配的 library ID
`query-docs`	用 library ID 拉取具体文档内容

二、前置条件

Claude Code CLI 已安装
Node.js >= 18（仅本地 npx 模式需要）

三、接入方式

方式一：一键安装（推荐）

bash 复制代码

npx ctx7 setup --claude

运行后做两个选择：

模式选 MCP server（不要选 CLI + Skills）
浏览器 OAuth 登录授权

完成后自动完成三件事：生成 API Key → 写入 MCP 配置 → 安装触发规则和 Skill。

API Key 由 OAuth 自动生成，无需手动去 dashboard 复制
Windows 上会自动选用远程 HTTP 模式（https://mcp.context7.com/mcp），不依赖本地 shell

卸载：

bash 复制代码

npx ctx7 remove

方式二：claude mcp add 命令行

如果不想走 OAuth 流程，或已从 context7.com/dashboard 手动获取了 API Key：

bash 复制代码

# 远程 HTTP 模式（Windows 首选）
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: 你的API_KEY"

# 本地 npx 模式（需 Node.js >= 18）
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

方式三：手动编辑配置文件

适合需要版本控制、团队共享的场景。

全局配置 （所有项目生效）→ ~/.claude.json：

json 复制代码

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "你的API_KEY"
      }
    }
  }
}

项目级配置 （仅当前项目）→ 项目根目录 .mcp.json：

json 复制代码

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

方式四：CLI + Skills（备选，不推荐）

不走 MCP 协议，通过 ctx7 命令行工具查文档。适合不支持 MCP 的编辑器。Agent 每次查询要多绕一层 shell 调用，速度和可靠性都不如 MCP 模式。

四、Windows 注意事项

本地 npx 模式 如遇到 MCP error -32000: Connection closed，需在配置中用 cmd /c 包裹：
json 复制代码
```
{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"]
}
```
更省事的做法：直接用远程 HTTP 模式（方式一 OAuth 安装会自动选这个），完全绕过 Windows shell 兼容问题。

五、验证

bash 复制代码

claude mcp list

看到 context7 且状态为 connected 即成功。

六、使用方式

重启 Claude Code 会话后（新 MCP server 不会在当前会话加载），直接提问即可自动触发：

"用 context7 查一下 React 19 的 use() hook 怎么用"

"Prisma 6 的 accelerate 扩展怎么配置"

Agent 会按照规则自动执行：resolve-library-id → 选最佳匹配 → query-docs → 基于文档回答。

七、各方式对比总结

维度	方式一 `ctx7 setup`	方式二 `claude mcp add`	方式三手动 JSON	方式四 CLI+Skills
上手难度	最低	低	中	中
API Key	OAuth 自动生成	需手动获取	需手动获取	OAuth 自动生成
Windows 兼容	自动选 HTTP 模式	HTTP 模式无兼容问题	手动选对模式即可	依赖 shell
团队共享	❌ 写用户级配置	❌ 写用户级配置	✅ `.mcp.json` 可提交	❌
协议	MCP	MCP	MCP	非 MCP
推荐度	⭐⭐⭐	⭐⭐	⭐⭐	⭐