context7-docs

用途

context7-docs 用于通过 Context7 MCP（Upstash）为任意库或框架获取最新文档与代码片段。当子代理需要最新 API 文档、代码示例或特定版本参考资料来完成实现时，可使用该技能。

主要能力

该技能提供两个工具：

• resolve-library-id：根据名称查找 Context7 库 ID。
• query-docs：根据库 ID 获取文档与代码片段。

resolve-library-id 的返回结果包含：库 ID（/org/project 格式，例如 /vercel/next.js）、代码片段数量、来源声誉（High/Medium/Low）、基准评分（最高 100 的质量指标）以及可用版本专用 ID。

前置条件

• 已安装 mcporter（路径 /opt/homebrew/bin/mcporter）。
• 已配置 Context7 服务器：

mcporter config add context7 --transport http --url "https://mcp.context7.com/mcp"

验证配置：

mcporter list context7 --schema

使用方式

步骤一：解析库 ID

mcporter call context7.resolve-library-id \
  query="How to set up authentication" \
  libraryName="next.js" \
  --output json

步骤二：查询文档

mcporter call context7.query-docs \
  libraryId="/vercel/next.js" \
  query="app router middleware setup" \
  --output json

返回结果为最新的文档与代码示例。

规则

• 始终先执行 resolve-library-id，再执行 query-docs（除非用户直接提供 /org/project 格式）。
• 每个问题中每个工具最多调用 3 次。
• 当匹配结果不明确时，选择基准评分与来源声誉最高的库。
• 版本专用查询：使用解析结果中的 /org/project/version 格式。

子代理集成模式

当子代理需要最新文档用于实现时：

1. mcporter call context7.resolve-library-id query="<task description>" libraryName="<lib>"
2. 从结果中选择最佳库 ID
3. mcporter call context7.query-docs libraryId="<id>" query="<specific question>"
4. 在实现中使用返回的文档与代码片段

常见库

• Next.js：/vercel/next.js 或 /websites/nextjs
• React：/facebook/react
• Prisma：/prisma/prisma
• Tailwind：/tailwindlabs/tailwindcss
• Stripe：/stripe/stripe-node

始终使用 resolve-library-id 进行验证——库 ID 可能发生变化。

适用场景

适用于子代理在编写或调整代码时，需要查询某个库或框架的最新文档、API 用法、代码示例或特定版本参考资料的情况。

限制

该技能依赖 mcporter 与 Context7 服务器配置；文档中未提供收费、价格、平台或具体效果方面的信息。