Lets an AI client query your team's AI coding history and act on HypAware recommendations.
다른 이름 hyparam/hypaware-plugin, hypaware-plugin
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 3,763
- 최신 버전
- 1.43.0
- 마지막 커밋
- 2026년 10월 20일
- 라이선스
- MIT
HypAware MCP란?
HypAware은(는) MCP server입니다. Lets an AI client query your team's AI coding history and act on HypAware recommendations.
프로젝트 README에서 생성된 요약
HypAware MCP server 정보
Querying your team's AI coding history and acting on specific recommendations is what HypAware enables for developers using AI agents. By connecting Claude Code, Cursor, or other agents via the hosted MCP server, users can access historical context and implement suggestions directly through their coding interface. The connection requires an agent token provided via the HYPAWARE_AGENT_TOKEN environment variable.
This setup provides two specific skills: hypaware-query for interacting with history and recommendations, and hypaware-reference for understanding data flow. The plugin functions as a read-only interface that does not record data or run local binaries, as recording is handled separately by the hyp CLI. Users can choose between the hosted remote server or running the npm package locally if they use the HypAware collector on their machine.
Security is managed through tokens minted via the CLI, which can be scoped for query access only. These tokens allow the agent to read organization history, mark recommendation statuses, and manage reports, but they cannot change configurations or manage the organization.
활용 사례
- 1Querying historical coding patternsAsk your AI agent to search through your team's previous AI-assisted coding sessions to find specific implementations.
- 2Implementing architectural recommendationsDirect your AI client to apply specific improvements suggested by the HypAware system.
- 3Managing recommendation statusUse your agent to update how a specific recommendation is being handled within your organization.
- 4Generating team reportsInstruct your coding agent to publish or delete reports based on the collected coding history.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HypAware MCP 설치 방법
형식 확인: 2026년 11월 10일Claude Code에 HypAware MCP 설치
$ claude mcp add hypaware-plugin -- npx -y hypawareCursor에 HypAware MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"hypaware-plugin": {
"command": "npx",
"args": [
"-y",
"hypaware"
]
}
}
}VS Code에 HypAware MCP 설치
.vscode/mcp.json
{
"servers": {
"hypaware-plugin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hypaware"
]
}
}
}Claude Desktop에 HypAware MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"hypaware-plugin": {
"command": "npx",
"args": [
"-y",
"hypaware"
]
}
}
}Codex에 HypAware MCP 설치
~/.codex/config.toml
[mcp_servers.hypaware-plugin] command = "npx" args = ["-y", "hypaware"]
Gemini CLI에 HypAware MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"hypaware-plugin": {
"command": "npx",
"args": [
"-y",
"hypaware"
]
}
}
}자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지와 의존성에 심각한 보안 권고 없음통과
README
GitHub에서 보기HypAware plugin
Connect Claude Code, Cursor, or any agent that reads skills to the hosted HypAware MCP server. Your agent can then query your team's AI coding history and act on HypAware recommendations.
The plugin holds two things:
- The MCP connection to
https://api.hypaware.ai/v1/mcp, sent with your agent token in theAuthorizationheader. - Two skills:
hypaware-query(how to query the history and act on recommendations) andhypaware-reference(what HypAware is and how data flows). They are copies of the skills in the HypAware release this plugin is pinned to.
The plugin only reads and acts. It has no hooks, commands, agents, or
binaries; it records nothing and runs nothing on your machine. Recording
is the job of the hyp CLI and hyp attach.
Get a token
The plugin reads your token from the HYPAWARE_AGENT_TOKEN environment
variable. If you have never minted one:
- Install the CLI:
npm install -g hypaware. - Sign in for queries only:
hyp remote login --no-forward. This opens a browser sign-in and does not turn on any recording. - Mint a token:
hyp remote mint --scope query --label <where-it-runs>. It lasts the server's default, 21 days today. Ask for longer with--expires-days <n>, up to the server's limit (90 days by default). - Put it in the environment your client starts in, such as
export HYPAWARE_AGENT_TOKEN=<token>in your shell profile, or in the client's own secret store. Never put it in a file you commit. - When you stop using it, revoke it:
hyp remote tokenslists your tokens andhyp remote tokens revoke <jti>revokes one.
What the token can do. It acts as you, the person who minted it, until it expires or you revoke it. It can read your organization's recorded history, mark a recommendation's status, publish reports, and delete reports. It cannot change configuration, record or upload sessions, manage the organization, or mint more tokens. Anyone holding it can do the same, so keep it secret.
Install
Claude Code
In Claude Code:
/plugin marketplace add hyparam/hypaware-plugin
/plugin install hypaware@hypaware
Or from a shell:
claude plugin marketplace add hyparam/hypaware-plugin
claude plugin install hypaware@hypaware
Start Claude Code from a shell where HYPAWARE_AGENT_TOKEN is set. If
claude mcp list shows the hypaware server as "Failed to connect" with
HTTP 401, the token is unset or no longer valid.
Cursor, for a team
A team admin opens the Cursor dashboard, then Plugins & MCPs, Add
Marketplace, Import from Repo, and enters hyparam/hypaware-plugin. The
admin then sets HYPAWARE_AGENT_TOKEN under Plugins, Configure. Cursor
lets only team admins set plugin variables.
Cursor, for one person
Cursor has no plugin install for one person, so set it up in two steps:
- Add the remote
hypawareblock from the Cursor section of the MCP guide to~/.cursor/mcp.json(or a project's.cursor/mcp.json). It reads the token as${env:HYPAWARE_AGENT_TOKEN}, so export the token before you start Cursor. - Add the skills:
npx skills add hyparam/hypaware-plugin -a cursor.
Other agents
For any agent the skills CLI knows (Pi, Codex, OpenCode and others):
npx skills add hyparam/hypaware-plugin
This installs the two skills only. Connect the MCP server by following the MCP guide for your client.
If you already run hyp attach
hyp attach installs the same skills. With it, you need the plugin only for
the MCP connection. In Claude Code both copies load side by side (the
plugin's are named hypaware:hypaware-query and so on), so nothing is
overwritten.
The MCP Registry entry
registry/server.json lists two ways to run the server:
- The remote is the hosted server. Pick it if you have an agent token.
- The npm package runs
hyp mcp serveagainst your own local HypAware data. Pick it if you run the HypAware collector on your machine; without the collector it has nothing to show.
Updating the skills
Never edit a file under skills/ by hand. Change the skill in
hypaware, release it, then run
node scripts/sync-skills.js <version> here and commit the result. CI fails
if skills/ differs from that release or any version field disagrees with
it.
License
MIT. See LICENSE.
HypAware MCP 질문
HypAware MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add hypaware-plugin -- npx -y hypaware를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HypAware MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
How do I get a HypAware agent token?
Install the CLI with npm, sign in for queries only with hyp remote login --no-forward, then mint a token with hyp remote mint --scope query --label <where-it-runs>. Tokens last 21 days by default and can be extended up to the server limit.
What can a HypAware agent token do?
It acts as the person who minted it and can read your organization's recorded history, mark recommendation status, publish reports, and delete reports. It cannot change configuration, record or upload sessions, manage the organization, or mint more tokens.
Does the HypAware plugin record my activity?
No. The plugin only reads and acts; it has no hooks, commands, agents, or binaries and records nothing on your machine. Recording is handled by the hyp CLI and hyp attach.
Why does my HypAware MCP server fail to connect with HTTP 401?
An HTTP 401 means the HYPAWARE_AGENT_TOKEN is unset or no longer valid. Start your client from a shell where the token is exported, or mint a new token.