HypAware

HypAware 插件

将 Claude Code、Cursor 或任何能够读取技能的 Agent 连接到托管的 HypAware MCP 服务。随后，你的 Agent 就能查询团队的 AI 编码历史，并根据 HypAware 的建议采取行动。

该插件包含两项内容：

• MCP 连接：连接到 https://api.hypaware.ai/v1/mcp，并在 Authorization 标头中发送你的 Agent 令牌。
• 两项技能：hypaware-query（介绍如何查询历史记录并根据建议采取行动）和 hypaware-reference（介绍 HypAware 是什么，以及数据如何流转）。它们是该插件所固定到的 HypAware 版本中技能的副本。

该插件只读取信息并采取行动。它没有钩子、命令、Agent 或二进制文件；不会记录任何内容，也不会在你的机器上运行任何程序。记录工作由 hyp CLI 和 hyp attach 完成。

获取令牌

插件从 HYPAWARE_AGENT_TOKEN 环境变量中读取令牌。如果你还没有创建过令牌：

1. 安装 CLI：npm install -g hypaware。
2. 仅为查询登录：hyp remote login --no-forward。这会打开浏览器进行登录，不会启用任何记录功能。
3. 创建令牌：hyp remote mint --scope query --label <where-it-runs>。该令牌的有效期为服务器默认期限，目前为 21 天。使用 --expires-days <n> 可申请更长的有效期，但不得超过服务器限制（默认上限为 90 天）。
4. 将令牌添加到客户端启动时所处的环境中，例如在 shell 配置文件中设置 export HYPAWARE_AGENT_TOKEN=<token>，或将其存入客户端自己的密钥存储中。切勿将其放入会提交的文件中。
5. 不再使用时，请撤销令牌：hyp remote tokens 会列出你的令牌，hyp remote tokens revoke <jti> 可撤销其中一个。

令牌的权限。 在令牌过期或被撤销前，它会以创建者（也就是你）的身份运行。它可以读取组织已记录的历史记录、标记建议的状态、发布报告和删除报告。它不能更改配置、记录或上传会话、管理组织，也不能创建更多令牌。持有该令牌的任何人都能执行相同操作，因此请妥善保密。

安装

Claude Code

在 Claude Code 中：

/plugin marketplace add hyparam/hypaware-plugin
/plugin install hypaware@hypaware

或者在 shell 中：

claude plugin marketplace add hyparam/hypaware-plugin
claude plugin install hypaware@hypaware

请在设置了 HYPAWARE_AGENT_TOKEN 的 shell 中启动 Claude Code。如果 claude mcp list 显示 hypaware 服务“Failed to connect”并返回 HTTP 401，则表示令牌未设置或已失效。

Cursor，供团队使用

团队管理员打开 Cursor 控制面板，然后依次选择 Plugins & MCPs、Add Marketplace、Import from Repo，并输入 hyparam/hypaware-plugin。随后，管理员在 Plugins、Configure 下设置 HYPAWARE_AGENT_TOKEN。Cursor 仅允许团队管理员设置插件变量。

Cursor，供个人使用

Cursor 不支持个人安装插件，因此请分两步完成设置：

1. 将 MCP 指南中的 Cursor 部分里的远程 hypaware 配置块添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）。它通过 ${env:HYPAWARE_AGENT_TOKEN} 读取令牌，因此请在启动 Cursor 前导出令牌。
2. 添加技能：npx skills add hyparam/hypaware-plugin -a cursor。

其他 Agent

对于 skills CLI 支持的任何 Agent（Pi、Codex、OpenCode 等）：

npx skills add hyparam/hypaware-plugin

这只会安装两项技能。请根据适用于你的客户端的 MCP 指南连接 MCP 服务。

如果你已在运行 hyp attach

hyp attach 会安装相同的技能。使用它时，你只需通过插件连接 MCP 服务。在 Claude Code 中，两份技能会并行加载（插件中的技能名称为 hypaware:hypaware-query 等），因此不会覆盖任何内容。

MCP Registry 条目

registry/server.json 列出了两种运行服务的方式：

• 远程服务是托管服务。如果你有 Agent 令牌，请选择此项。
• npm 包会基于你本地的 HypAware 数据运行 hyp mcp serve。如果你在机器上运行 HypAware 采集器，请选择此项；没有采集器就没有内容可供查看。

更新技能

切勿手动编辑 skills/ 下的文件。在 hypaware 中更改技能并发布，然后在此处运行 node scripts/sync-skills.js <version> 并提交结果。如果 skills/ 与该版本的内容不一致，或任何版本字段与其不符，CI 就会失败。

许可证

MIT。请参阅 LICENSE。