Hyperliquid / HyperEVM

hyperevm-mcp

用通俗语言询问 AI 助手有关 Hyperliquid 生态的问题。 它只读取信息。没有任何地方可以填写私钥，这正是整套安全机制。

"what's the best HYPE yield right now"

Network HYPE staking APR: 1.80%–2.25% across 27 active validators.
Anything far above this is a reward or a risk premium.

## Liquid staking (HYPE LSTs)
| Protocol       | Token |   APY |  7d |     TVL |
| -------------- | ----- | ----: | --: | ------: |
| Kinetiq kHYPE  | KHYPE | 1.94% | n/a | $825.9M |
| stHYPE         | —     |   n/a | n/a | $173.9M |
| Kinetiq kmHYPE | —     |   n/a | n/a |  $36.1M |

## Lending markets
| Protocol         | Asset | Supply | Borrow |  Util | Max LTV |    TVL |
| ---------------- | ----- | -----: | -----: | ----: | ------: | -----: |
| HyperLend Pooled | USDC  |  5.84% |  7.36% | 88.2% |   62.0% | $12.1M |
| HyperLend Pooled | USD₮0 |  5.15% |  7.94% | 72.2% |   62.0% |  $1.8M |
| HyperLend Pooled | WHYPE |  0.61% |  0.98% | 78.0% |   60.0% | $42.1M |

## Other HYPE yield (LP, looping, fixed-term)
| Protocol     | Pool                  |    APY |  Base |       7d |   TVL | IL  |
| ------------ | --------------------- | -----: | ----: | -------: | ----: | --- |
| nest CL      | WHYPE-USDC (0.0638%)  | 38.80% |   n/a |  +0.33pp | $5.9M | yes |
| nest CL      | WHYPE-UBTC (0.2%)     | 32.78% |   n/a |  -9.93pp | $1.7M | yes |
| Ramses CL V2 | WHYPE-USDC (CL 0.11%) | 30.14% | 0.00% | -29.96pp | $1.8M | yes |

## Protocol vaults
| Vault                         |     TVL |     24h |      7d |     30d |
| ----------------------------- | ------: | ------: | ------: | ------: |
| Hyperliquidity Provider (HLP) | $225.7M | -0.003% | +0.010% | -0.024% |

Note: 3 of the rows above are mostly token emissions rather than earned yield.
Compare the APY and Base columns — emissions stop when the issuing team
decides they stop.

其中四项显示为 n/a。这正是重点：stHYPE 没有公布收益池，而 kHYPE 的周变化数据来自源数据，暗示该池在七天前没有收益，但这与其自身的每日历史记录相矛盾。我们无法为一个数字背书，就不会显示它。

金库这一行也两次体现了同样的原则。DefiLlama 上完全没有 HLP 的池，因此仅依赖该数据源构建的表格会悄然漏掉链上最大的单一存款去处——这里改为从 Hyperliquid 读取数据。而 Hyperliquid 自己提供的 HLP APR 字段也不会显示，因为同一个数值作为年利率和日利率时，含义会相差 365 倍，而金库的历史记录无法确定究竟是哪一种。这里显示的是各时间窗口内已实现的盈亏，并除以相应时长；这套计算方式由我们负责解释。

然后，问问是否该相信其中一个利率：

"has that Ramses WHYPE-USDC pool actually been paying 100%?"

## Pool history
Pool:                   WHYPE-USDC
Project:                Ramses CL V2
APY now:                16.86%
APY 7d ago:             144.75%
APY 30d ago:            107.77%
Earned vs emitted now:  0.00% earned · 16.86% emitted
TVL change over window: -10.7%

| Date (UTC) |     APY | Earned | Emitted |   TVL |
| ---------- | ------: | -----: | ------: | ----: |
| 2026-06-27 | 107.77% |  0.00% | 107.77% | $1.9M |
| 2026-07-09 |  70.09% |  0.00% |  70.09% | $2.0M |
| 2026-07-21 |  58.80% |  0.00% |  58.80% | $1.8M |
| 2026-07-26 |  16.86% |  0.00% |  16.86% | $1.7M |

整整一个月，每天收益都是零。

安装

Claude Code

claude mcp add hyperevm -- npx -y @sand0vvv/hyperevm-mcp

Cursor、Claude Desktop 或任何 MCP 客户端——添加到配置文件中：

{
  "mcpServers": {
    "hyperevm": {
      "command": "npx",
      "args": ["-y", "@sand0vvv/hyperevm-mcp"]
    }
  }
}

设置就这么多。之后无需填写任何内容——没有需要进行身份验证的账户。

试着这样提问

• 现在 HYPE 的最佳收益是什么
• 比较 HyperEVM 上的借贷利率
• 哪些 HYPE 池只有代币排放，哪些池真的有收益
• 40% APY 能维持住吗，还是正在下降
• BTC 资金费率真的稳定吗，还是只稳定了那一个小时
• 这条链上谁赚取的手续费最多
• 我真的能卖出 50 万美元的 HYPE 吗
• 本周哪些协议增长了
• 介绍一下 HyperLend
• 这个钱包里有什么：0x…
• 我应该在哪里质押 HYPE，佣金要花多少钱

工具

共有九个工具。五个报告当前情况，三个说明情况如何发展至此，还有一个读取地址信息。

工具	回答的问题
hyperevm_yields	一张表展示 HYPE 的所有收益：流动性质押、借贷（包括供应量／借款量／利用率／最大 LTV）、LP 和循环借贷，以及 HLP 金库——并将实际赚取的收益与代币排放分开
hyperevm_protocols	HyperEVM 上部署了什么：链上 TVL、各协议 TVL、1 天／7 天变化，可按规模或每周增长排序；也可查看任意单个协议的详情卡片
hyperevm_fees	用户实际支付的手续费，按 24 小时／7 天／30 天排名。TVL 表示某处存有多少资金；此工具则显示是否有人付费使用它
hl_market	永续合约标记价格、每小时和年化资金费率、未平仓合约量、24 小时成交量；现货交易对；Hyperliquid、Binance 和 Bybit 的预测资金费率
hl_staking	按预测 APR 排名的 HYPE 验证者，并列出佣金、在线率和质押占比——即网络在封装协议抽取费用前支付的收益
hyperevm_pool_history	查看某个池数周以来的 APY 和 TVL，并区分实际赚取的收益与代币排放——据此核对宣传利率是否符合该池自身的历史表现
hl_funding	了解数日内资金费率的实际表现：平均值、范围、保持正负方向的时间比例，以及持仓需要支付的费用
hl_orderbook	查看价差和挂单深度，以及给定交易规模是否能在可见订单簿范围内成交——否则会明确说明无法成交
hyperevm_wallet	查询任意公开地址：账户价值、包含入场价格／未实现盈亏／清算价格的未平仓仓位、现货余额、HYPE 质押情况

这些工具的配对是有意设计的。hyperevm_yields 和 hl_market 会告诉你某个数字当前是多少；hyperevm_pool_history 和 hl_funding 则会告诉你是否应该相信它。一个收益率为 47%、整整一个月都完全依赖代币排放的池，与一个收益率为 20%、靠手续费赚取收益的池，并不是同一种产品；只有第二组工具才能分辨它们。

斜杠命令

此服务还提供 MCP 提示词，在 Claude Code 中会显示为斜杠命令：

提示词	作用
yield-report	一次性汇总质押、流动性质押、借贷和 LP，并按排名列出，同时标明代币排放
protocol-brief	针对单个协议：规模、机制、收益水平及比较情况
wallet-review	针对公开地址：敞口、每日资金成本、闲置余额
funding-scan	查看 Hyperliquid 的资金费率与 Binance 和 Bybit 的差异

此服务不会做什么

它没有写入功能。不是“默认禁用”——代码中根本不存在签名或发送任何内容的功能。

• 这里的任何内容都无法转移资金。 这个包中没有用于签署交易的代码。
• 也没有需要配置的内容：此服务不会读取环境变量，因此也没有任何内容会泄露。
• 它绝不会访问文件系统、启动进程，也不会向机器外发送遥测数据。
• 它只会与以下四个主机通信，这些主机硬编码在 src/core/http.ts 中： api.hyperliquid.xyz、api.llama.fi、yields.llama.fi、rpc.hyperliquid.xyz。 没有任何工具会将 URL、主机或链作为参数。

这些都不是承诺，而是测试。 npm run audit 会根据源代码检查以上每一项；如果其中任何一项不再成立，就会以非零状态码退出。它会在发布前于 CI 中运行；添加 fs 导入或第二个网络主机都会导致构建失败，而不会传到你手中：

$ npm run audit
capability
  ok    does not read or write the filesystem
  ok    does not spawn processes
  ok    does not open raw sockets or listen
  ok    does not evaluate code at runtime
  ok    reads no environment variables — there is nothing to configure
  ok    no crypto, signing or key handling anywhere
network surface
  ok    contacts exactly 4 hosts, all hardcoded
  ok    no tool accepts a URL, host or endpoint as a parameter
  ok    every outbound call goes through the allowlisted fetch wrapper
type-level guarantee
  ok    the Safe escape hatch exists in exactly one file
  ok    renderers accept only Safe text, so unsanitised output cannot compile
  ok    prompts are authored here, never assembled from network data
data handling
  ok    never reads free-text descriptions from upstream
  ok    stdout carries the MCP protocol only
  ok    every tool answers through the envelope, including on failure
supply chain
  ok    no install-time lifecycle scripts
  ok    exactly 2 direct dependencies
  ok    published tarball contains build output only

every claim in the README is enforced here

整个服务只有几千行 TypeScript。安装前，建议先阅读代码。

值得了解的三个细节

借贷利率并不在你以为的位置。 DefiLlama 的 /pools 会为抵押品市场报告 0.00%——这很准确，因为这些市场的供应利率确实为零。利率位于第二个端点 /lendBorrow，需要按池 ID 将其关联起来。简单的集成会在一个 $239M 的市场上显示一张全是零的表格。此服务会将两者关联起来，并分别显示供应、借款和利用率。

缺失的数据会明确显示为缺失。 stHYPE（$172M）和 beHYPE 在 DefiLlama 上没有收益池，因此它们的 APY 会显示为 n/a，同时列出实际 TVL；上方还会显示网络质押 APR 作为参考。用零代替“未知”，会是这个工具能显示的代价最高的错误。

代币排放不等于收益。 按醒目 APY 排名前列的池子，往往完全以自身代币支付。表格会在 APY 旁列出 Base 列，因此 48.86% / base 0.00% 能如实呈现情况，并附注说明哪些行的数值大部分来自代币排放。7d 列会显示这种情况随时间的变化：该池的 APY 在一周内下降了 30 个百分点。

第三方文本与提示词注入

此服务为只读服务，无法执行操作。但它会将陌生人编写的文本带入 Agent 的上下文，而 Agent 还可能拥有其他能力——例如钱包、Shell。Hyperliquid 上的验证者名称由验证者运营者自行设置，可以是任意文本；DefiLlama 的协议名称来自拉取请求。因此，我们通过三个层次将这些文本视为恶意内容。

1. 永远不读取不需要的字段。 description——验证者的描述最长 445 个字符，DefiLlama 协议的描述最长 599 个字符——不会在代码的任何地方解析。若此规则发生变化，审计会使构建失败。

2. 使用允许列表，而非拒绝列表。 所有输出内容都会通过一个过滤器，只保留字母、数字、货币符号和少量标点，并删除其他所有内容。这不是用于捕获恶意序列的列表，而是允许通过的内容列表。因此，<|im_start|>、[INST]、###、{{、反引号和表格竖线都无法保留，因为构成它们的字符不在允许列表中。输入会先进行 NFKC 规范化，再通过过滤器，因此全角相似字符会先转换为 ASCII，而不是在过滤后转换。

3. 依靠类型系统，而非自律。 清理后的文本有自己的类型。渲染器不接受其他类型，因此输出原始上游字段会导致编译错误，而不是在代码审查中被漏掉。从普通字符串创建这种类型的地方恰好只有一处；若出现第二处，审计会使构建失败。

有一项测试会将带有恶意内容的上游响应——聊天模板标记、javascript: URL、注入的指令、slug 中的代码围栏——通过真实工具处理，并断言这些内容不会以能够产生作用的形式出现在输出中。

此方法无法做到的事： 它无法阻止普通英文文本。名为 “ignore previous instructions” 的验证者仍会显示这些词语。对此的应对方式是字段白名单、24 字符上限，以及此服务没有可由这类句子触发的操作——而不是设计更聪明的过滤器。声称过滤器能解决提示词注入问题的人是在兜售东西。

详情请见 SECURITY.md。

要求

Node 20 或更高版本。两个直接依赖：@modelcontextprotocol/sdk 和 zod。 （SDK 会像其他所有 MCP 服务一样，带上自身的依赖树；除此之外不会再添加其他依赖。）

开发

npm install
npm test          # build, unit tests, behaviour checks — runs offline
npm run verify    # the above plus the self-audit and a real MCP handshake

单独运行：

npm run build
node scripts/test.mjs           # units: numbers, tables, the sanitiser, the cache
npm run check     # behaviour: injection end-to-end, allowlist, retry, stale fallback, outage
npm run audit     # enforces every claim in this README against the source
npm run preflight # fails if this repository contains anything that should not be public
npm run smoke     # every tool against the live public APIs
npm run stdio     # spawn the server and speak MCP to it

单元测试覆盖决定读者所见内容的部分：确保“未知”渲染为 n/a 而不是 0，确保百分点和百分比保持为不同单位，确保单元格无法伪造表格列，以及确保刷新失败时会返回上一条答案并说明原因。行为检查会将带有恶意内容的上游响应通过完整工具进行处理。

免责声明

非官方社区构建项目。与 Hyperliquid 或任何列出的协议均无关联。数据来自公共 API，可能延迟或有误；DefiLlama 大约每 30 分钟刷新一次。刷新失败时，会返回上一条答案，并显示“刷新失败，此数据已过 N 分钟”标签，而不是报错——旧数据有用，但伪装成新数据的旧数据没有用。 以上内容不构成财务建议。

MIT © sand0vvv