配置 Context7 MCP Server

配置 Context7 的 MCP Server 通常需要两个核心要素：API Key（密钥） 和 运行命令（Command）。

目前支持 MCP 协议的主流客户端主要是 Claude Desktop 和 Cursor。以下是具体的配置步骤：

📌 1. 准备工作

1.1 获取 API Key

1. 登录 context7.com。
2. 进入 Dashboard 或 Settings 页面。
3. 找到 API Keys 部分，生成一个新的 Key（通常是以 c7- 或类似的字符开头），复制并保存好。

1.2 确认环境

• 确保你的电脑上安装了 Node.js (建议 v18 以上版本)，因为大多数 MCP Server 是通过 npx 运行的。

📌 2. 在 Cursor 中配置 (推荐开发者使用)

Cursor 最近版本已经原生支持 MCP，配置界面非常友好。

1. 打开 Cursor，点击右上角的 齿轮图标 (Settings)。
2. 在设置菜单中找到 Features → MCP。
3. 点击 + Add New MCP Server。
4. 在弹出的窗口中填写以下信息（假设 Context7 官方提供的包名为 context7-mcp）：
   • Name: Context7 (这只是个名字，随便填)
   • Type: 选择 Command
   • Command: npx
   • Args: -y context7-mcp (注意：请在官网确认确切的包名，可能是 @context7/server 之类)
   • Environment Variables:
     • 点击 Add Variable
     • Key: CONTEXT7_API_KEY
     • Value: 粘贴你刚才复制的密钥
5. 点击 Save。如果配置正确，你会看到状态灯变绿，显示 "Connected"。

📌 3. 在 Claude Desktop 中配置

Claude Desktop 目前主要通过修改 JSON 配置文件来管理 MCP。

3.1 找到配置文件

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• 如果文件不存在，请手动创建一个。

3.2 编辑 JSON

用文本编辑器打开该文件，将 Context7 添加到 mcpServers 字段中：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "context7-mcp" 
      ],
      "env": {
        "CONTEXT7_API_KEY": "sk-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

(注意：请将 context7-mcp 替换为官网提供的实际包名，将 sk-xxx 替换为你的真实 Key)

3.3 重启 Claude

保存文件后，完全退出并重启 Claude Desktop。你会看到输入框右侧多了一个"插头"图标，里面应该能看到 Context7 工具。

📌 4. 在 Windsurf 中配置

Windsurf 的配置方式与 Claude Desktop 类似，也是修改 JSON 文件。

• 配置文件位置：通常位于 ~/.codeium/windsurf/mcp_config.json。
• 内容格式：与上面的 Claude JSON 格式完全一致。

📌 5. 在 Codex 中配置

Codex 的配置方式与 Cursor 类似，具体可参考其官方文档。配置界面同样支持添加 MCP Server，填写相应的 Command 和 Environment Variables 即可。

📌 6. 验证配置是否成功

配置完成后，你可以向 AI 发送以下测试指令：

"Check my Context7 tool connection and search for the latest documentation on React 19 hooks."

(检查我的 Context7 工具连接，并帮我搜索关于 React 19 hooks 的最新文档。)

成功的迹象

1. AI 的回复框上方会出现一个小的 Tool Use 或 Used Context7 的指示器。
2. AI 会准确输出文档内容，而不是说"我的知识截止于2023年..."。

📌 7. 常见问题排查

• 报错 command not found: npx：说明你的电脑没装 Node.js，或者没配置好环境变量。
• 报错 401 Unauthorized：API Key 填错了，或者该 Key 已失效/欠费。
• 一直在转圈 (Timeout)：网络问题，国内用户可能需要检查是否需要配置代理（在 command args 中可能需要添加代理参数，或者在 env 中设置 HTTPS_PROXY）。