版本: 2.88.0
名称: context7-使用模式 描述: “Context7 MCP 用于库文档的使用模式 (v2.25)”
Context7 MCP 使用模式
v2.88 关键变更 (模型无关)
- 模型无关: 使用在
~/.claude/settings.json或 CLI/环境变量中配置的模型 - 无需标志: 与配置的默认模型一起工作
- 灵活: 可与 GLM-5、Claude、Minimax 或任何配置的模型一起工作
- 设置驱动: 通过
ANTHROPIC_DEFAULT_*_MODEL环境变量进行模型选择
深度思考 - 深呼吸。我们不是来写代码的。我们是来改变世界的。
愿景
文档检索应该精确、快速且权威。
您的工作,逐步进行
- 识别库: 从用户的请求中提取
- 解析ID: 使用 Context7 查找确切的来源
- 查询: 请求有针对性的、可操作的指导
- 备用方案: 当 Context7 缺乏覆盖时使用 MiniMax
深度思考原则实践
- 不同思考: 优先选择索引文档而非网页抓取
- 执着细节: 确保正确的库 ID
- 像达芬奇一样规划: 在运行查询前定义查询
- 精心制作,而非编码: 仅返回相关摘录
- 不懈迭代: 为清晰度重新查询
- 无情简化: 避免不必要的搜索
Context7 MCP 使用模式
概述
Context7 MCP 为流行的库和框架提供索引文档。它比网页抓取更高效,因为它使用预索引的、结构化的文档。
可用工具
| 工具 | 目的 | 参数 |
|---|---|---|
mcp__plugin_context7_context7__resolve-library-id |
查找 Context7 库 ID | libraryName, query |
mcp__plugin_context7_context7__query-docs |
查询文档 | libraryId, query |
使用模式
# 步骤 1: 解析库 ID
mcp__plugin_context7_context7__resolve-library-id:
libraryName: "React" # 从用户查询中提取
query: "useTransition hook usage" # 用于排名的完整查询
# 步骤 2: 使用解析的 ID 查询文档
mcp__plugin_context7_context7__query-docs:
libraryId: "/vercel/next.js" # 来自步骤 1
query: "How to use useTransition hook"
决策树
这是关于库/框架的吗?
|
+-- 是 --> 它在 Context7 中吗?
| |
| +-- 是 --> 使用 Context7 MCP
| | 1. resolve-library-id
| | 2. query-docs
| |
| +-- 否 --> 回退到 MiniMax MCP
|
+-- 否 --> 使用 WebSearch (原生) 或 MiniMax MCP
支持的库 (示例)
前端
- React (
/facebook/react) - Next.js (
/vercel/next.js) - Vue.js (
/vuejs/vue) - Angular (
/angular/angular) - Svelte (
/sveltejs/svelte)
语言
- TypeScript (
/microsoft/TypeScript) - JavaScript (MDN)
后端
- Node.js (
/nodejs/node) - Express (
/expressjs/express) - Fastify (
/fastify/fastify)
CSS/UI
- Tailwind CSS (
/tailwindlabs/tailwindcss) - Chakra UI (
/chakra-ui/chakra-ui)
数据库
- PostgreSQL
- MongoDB (
/mongodb/docs) - Redis
成本优化
| 方法 | 令牌使用量 | 质量 |
|---|---|---|
| Context7 | 约减少 50% | 高 (官方文档) |
| 网页搜索 | 基准 | 可变 |
| MiniMax | 基准 | 高 |
为什么 Context7 节省令牌:
- 预索引文档
- 结构化响应
- 无网页抓取开销
- 专注、相关的内容
与 Ralph Loop 集成
# CLI 使用
ralph library "React 19 useTransition"
ralph lib "Next.js 15 app router"
ralph docs "TypeScript generics"
# 斜杠命令
/library-docs React hooks best practices
备用策略
如果 Context7 没有该库:
- 记录警告: “库在 Context7 中未找到”
- 回退到
mcp__MiniMax__web_search - 返回 MiniMax 的结果
最佳实践
- 首先提取库名称 - 解析用户查询以识别库
- 使用完整查询进行排名 - 将完整查询传递给 resolve-library-id
- 优雅处理未找到 - 始终准备好 MiniMax 备用方案
- 与代码示例结合 - 在您的提示中请求代码片段