Context7 MCP 配置¶

Context7 为 AI 编程助手索引最新文档。Acute 已注册已发布的 AQPXLIB 文档，助手可检索准确的 API 参考与示例，而不必依赖过时的训练数据。

资源	链接
已发布文档	acute-technology-inc.github.io/pxlib-docs
文档源码仓库	github.com/acute-technology-inc/pxlib-docs
Context7 库页面	context7.com/acute-technology-inc/pxlib-docs
Context7 网站页面	context7.com/websites/acute-technology-inc_github_io_pxlib-docs

先决条件¶

支持 Model Context Protocol (MCP) 的 AI 助手（例如 Cursor）。
Context7 账户。通过下方安装流程登录；Context7 支持 OAuth 与 API 密钥。详见 Context7 快速入门。

推荐安装方式（Cursor）¶

在 Cursor 中启用 Context7 的最快方式是官方安装命令：

npx ctx7 setup --cursor

该命令会完成 Context7 身份验证，在 ~/.cursor/mcp.json 中配置 MCP 服务器，并安装可自动调用 Context7 的技能。

安装后请重启 Cursor。其他选项（项目级配置、规则、Composer 技巧）见在 Cursor 中使用 Context7。

可选：面向 AQPXLIB 的 Cursor 规则¶

在 exerciser 自动化相关工作中优先使用 AQPXLIB 文档时，可在 Cursor 设置 → Rules and Commands 中添加规则：

当我询问 AQPXLIB、aqpxlib、Protocol Exerciser Python API、I2C、I3C、UART 或 Acute 硬件上的 GPIO 时，请使用 Context7 MCP，库 ID 为 /acute-technology-inc/pxlib-docs。

手动 MCP 配置（Cursor）¶

若自行配置 MCP，将以下之一添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）。请勿将 API 密钥提交到 git。

API 密钥（远程服务器）OAuth（远程服务器）

在 Context7 控制台创建 API 密钥，然后使用：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Context7-API-Key": "YOUR_CONTEXT7_API_KEY"
      }
    }
  }
}

本地 stdio 模式及其他客户端见 Context7 MCP 配置。

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp/oauth"
    }
  }
}

保存后重启 Cursor，并在提示时完成 OAuth 登录。

其他 AI 助手¶

Context7 支持 Claude Code、OpenCode 及其他 MCP 客户端。运行 npx ctx7 setup 并选择你的代理，或参阅 Context7 文档索引中的客户端列表。

验证访问¶

修改 MCP 设置后重启助手。
询问具体的 AQPXLIB 主题。
确认回答引用了当前文档（例如 pxlib-docs 中的 GPIO、I2C 或 I3C 页面）。

Context7 上的文档会在 Acute 发布新的 pxlib-docs 版本时更新；需要助手中的最新 API 行为时请使用 Context7。