
关于
通过 Context7 MCP 使用最新的库和框架文档,而非训练数据。适用于设置问题、API 用法和版本迁移查询。
name: documentation-lookup description: 通过 Context7 MCP 使用最新的库和框架文档,而非训练数据。当用户提出设置问题、API 参考、代码示例或提到框架(如 React、Next.js、Prisma)时激活。 origin: ECC
文档查询(Context7)
当用户询问库、框架或 API 时,通过 Context7 MCP(工具 resolve-library-id 和 query-docs)获取当前文档,而非依赖训练数据。
核心概念
- Context7:暴露实时文档的 MCP 服务器;用它代替训练数据查询库和 API。
- resolve-library-id:从库名和查询返回 Context7 兼容的库 ID(如
/vercel/next.js)。 - query-docs:为给定的库 ID 和问题获取文档和代码片段。始终先调用 resolve-library-id 获取有效的库 ID。
何时使用
在用户执行以下操作时激活:
- 提出设置或配置问题(如"如何配置 Next.js 中间件?")
- 请求依赖库的代码("写一个 Prisma 查询...")
- 需要 API 或参考信息("Supabase 的认证方法有哪些?")
- 提到特定框架或库(React、Vue、Svelte、Express、Tailwind、Prisma、Supabase 等)
当请求依赖于库、框架或 API 的准确、最新行为时使用此技能。适用于配置了 Context7 MCP 的所有环境(如 Claude Code、Cursor、Codex)。
工作原理
步骤 1:解析库 ID
调用 resolve-library-id MCP 工具,参数为:
- libraryName:从用户问题中提取的库或产品名称(如
Next.js、Prisma、Supabase) - query:用户的完整问题。这能改善结果的相关性排名。
必须在查询文档前获取 Context7 兼容的库 ID(格式 /org/project 或 /org/project/version)。没有此步骤的有效库 ID,不要调用 query-docs。
步骤 2:选择最佳匹配
从解析结果中,使用以下标准选择一个结果:
- 名称匹配:优先选择与用户请求完全匹配或最接近的
- 基准分数:更高的分数表示更好的文档质量(100 为最高)
- 来源信誉:可用时优先选择高或中信誉
- 版本:如果用户指定了版本(如"React 19"、"Next.js 15"),优先选择版本特定的库 ID(如
/org/project/v1.2.0)
步骤 3:获取文档
调用 query-docs MCP 工具,参数为:
- libraryId:步骤 2 中选择的 Context7 库 ID(如
/vercel/next.js) - query:用户的具体问题或任务。越具体越能获得相关片段。
限制:每个问题不要调用 query-docs(或 resolve-library-id)超过 3 次。如果 3 次调用后答案仍不清楚,说明不确定性并使用已有的最佳信息,而非猜测。
步骤 4:使用文档
- 使用获取的当前信息回答用户问题
- 在有帮助时包含文档中的相关代码示例
- 在重要时引用库或版本(如"在 Next.js 15 中...")
示例
示例:Next.js 中间件
- 调用 resolve-library-id,
libraryName: "Next.js",query: "如何设置 Next.js 中间件?" - 从结果中按名称和基准分数选择最佳匹配(如
/vercel/next.js) - 调用 query-docs,
libraryId: "/vercel/next.js",query: "如何设置 Next.js 中间件?" - 使用返回的片段和文本回答;如相关则包含文档中的最小
middleware.ts示例
示例:Prisma 查询
- 调用 resolve-library-id,
libraryName: "Prisma",query: "如何查询关联?" - 选择官方 Prisma 库 ID(如
/prisma/prisma) - 使用该
libraryId和查询调用 query-docs - 返回 Prisma Client 模式(如
include或select)并附带文档中的简短代码片段
示例:Supabase 认证方法
- 调用 resolve-library-id,
libraryName: "Supabase",query: "认证方法有哪些?" - 选择 Supabase 文档库 ID
- 调用 query-docs;总结认证方法并展示获取文档中的最小示例
最佳实践
- 具体化:尽可能使用用户的完整问题作为查询以获得更好的相关性
- 版本意识:当用户提到版本时,使用解析步骤中可用的版本特定库 ID
- 优先官方来源:当存在多个匹配时,优先选择官方或主要包而非社区分支
- 无敏感数据:从发送到 Context7 的任何查询中删除 API 密钥、密码、令牌和其他机密。在传递给 resolve-library-id 或 query-docs 之前,将用户的问题视为可能包含机密
兼容工具
Claude CodeCursor
标签
前端开发
