快速配置
选择适合您环境的设置。
最后验证: 2026-05-25
验证环境: Context7 远程 MCP，或 @upstash/context7-mcp 使用 stdio
安装命令:
npx -y @upstash/context7-mcp@latest本地配置
JSON 本地配置 json
{
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"],
"env": {
"CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}"
}
}
}验证提示词
使用 Context7 查找当前 Next.js middleware 文档，并总结 auth redirect 示例。
成功时应看到
应看到带版本意识的文档片段，而不是泛泛的框架建议。
常见陷阱与修复
- ⚠️ 注意: API 漂移、框架示例过期，以及版本相关文档难找。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- Context7 用来查文档；不要把文档片段当作无需测试的可执行事实。
- 把 CONTEXT7_API_KEY 放在环境变量或远程 MCP header 中，不要提交到配置文件。
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
request timed out | 本地 npx 服务启动慢，或 host 启动超时。 | 增加 MCP 启动超时，固定使用 @latest，或在 host 支持时改用托管 Context7 MCP URL。 |
rate limited | 未认证免费额度已用完。 | 创建 Context7 API key，并以 CONTEXT7_API_KEY 注入。 |
wrong library | 库名解析到了错误的包或文档源。 | 先让 Context7 resolve library ID，再查询精确 ID。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 用 Context7 查找最新 Astro routing 文档，并说明正确的动态路由模式。
- 找到当前 Supabase 邮箱密码注册 API，并给出最小 TypeScript 示例。
- 编辑前先查当前 Tailwind CSS container query 文档，并总结相关 class。