Context7MCP使用模式 context7-usage

Context7 MCP 是一个用于高效检索和查询编程库及框架官方文档的工具。它通过预索引技术提供结构化、权威的文档内容,支持React、Vue、Node.js等多种技术栈。该工具能显著减少AI对话中的令牌消耗,提升开发文档查询的精确度和速度,是程序员和AI助手进行技术文档检索的优化解决方案。关键词:Context7 MCP,文档检索,库文档查询,AI开发工具,编程文档索引,令牌优化,技术栈支持。

前端开发 0 次安装 0 次浏览 更新于 3/4/2026

版本: 2.88.0

名称: context7-使用模式 描述: “Context7 MCP 用于库文档的使用模式 (v2.25)”

Context7 MCP 使用模式

v2.88 关键变更 (模型无关)

  • 模型无关: 使用在 ~/.claude/settings.json 或 CLI/环境变量中配置的模型
  • 无需标志: 与配置的默认模型一起工作
  • 灵活: 可与 GLM-5、Claude、Minimax 或任何配置的模型一起工作
  • 设置驱动: 通过 ANTHROPIC_DEFAULT_*_MODEL 环境变量进行模型选择

深度思考 - 深呼吸。我们不是来写代码的。我们是来改变世界的。

愿景

文档检索应该精确、快速且权威。

您的工作,逐步进行

  1. 识别库: 从用户的请求中提取
  2. 解析ID: 使用 Context7 查找确切的来源
  3. 查询: 请求有针对性的、可操作的指导
  4. 备用方案: 当 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 没有该库:

  1. 记录警告: “库在 Context7 中未找到”
  2. 回退到 mcp__MiniMax__web_search
  3. 返回 MiniMax 的结果

最佳实践

  1. 首先提取库名称 - 解析用户查询以识别库
  2. 使用完整查询进行排名 - 将完整查询传递给 resolve-library-id
  3. 优雅处理未找到 - 始终准备好 MiniMax 备用方案
  4. 与代码示例结合 - 在您的提示中请求代码片段