Hyperliquid Mcp

io.github.kitsune-de由 GitHub 账号 kitsune-de 发布v0.1.0更新于 Oct 24, 2026

Read-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

一个只读的 MCP 服务器，让助手查询 Hyperliquid 永续合约市场、资金费率、订单簿、K 线，以及任意地址的持仓和成交记录。

可以做什么
查询永续市场，获取标记价格、24 小时涨跌、成交量、未平仓量、资金费率与最高杠杆，并获取指定币种或全部永续合约的中间价。读取 L2 订单簿快照，包含最优买卖价与价差，并拉取 1 分钟到 1 周的 OHLCV K 线。查看任意地址的账户价值、保证金占用、含强平价格的持仓以及现货余额。查看挂单与近期成交，包括方向、名义金额、已平仓盈亏和手续费。按币种汇总指定时间窗口内的净资金费支出或收入。
适用场景
适合让助手分析 Hyperliquid 永续市场，或查看自己及他人公开地址的链上交易情况，且不需要任何交易能力。适用于资金费率对比、订单簿与 K 线研判，以及持仓和强平风险相关问题。
运行要求
以 stdio 方式在本地运行，通常通过 npm 包用 npx 启动，需要 Node.js 以及访问 Hyperliquid Info API 的网络连接。无需 API 密钥或钱包。可选环境变量 HL_INFO_URL 可改为指向测试网端点。
安装前请注意
设计上只读，无法交易或签名，但它会查询任意地址的公开链上数据，因此你询问的账户信息会发送给上游 API。市场数据仅供参考，不构成投资建议，行动前请自行核实数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hyperliquid Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

hyperliquid-mcp

Give your AI agent eyes on Hyperliquid. A tiny, read-only MCP server that lets Claude (or any MCP-compatible agent) query Hyperliquid perp markets, funding rates, order books, candles — and the positions, fills and funding of any address.

  • 🔑 No API keys, no wallets, no signing — only the public Info API. It cannot trade, ever.
  • 📦 Zero config — one entry in your MCP config and you're done.
  • 🪶 Tiny — two source files, two dependencies (MCP SDK + zod).

Quick start

Claude Code

bash
claude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcp

Claude Desktop / Cursor / any MCP client

json
{  "mcpServers": {    "hyperliquid": {      "command": "npx",      "args": ["-y", "@kitsune-de/hyperliquid-mcp"]    }  }}

From source

bash
git clone https://github.com/kitsune-de/hyperliquid-mcpcd hyperliquid-mcp && npm install && npm run build# then point your MCP client at: node /path/to/hyperliquid-mcp/dist/index.js

What you can ask

"What are the most extreme funding rates on Hyperliquid right now?"

"Show the open positions and liquidation prices of 0xabc… — how close is it to liquidation?"

"How much funding did my account pay over the last week, per coin?"

"Pull 4h candles for HYPE and describe the trend."

Tools

ToolArgumentsReturns
get_marketscoin?, sortBy? (volume · funding · change · openInterest), limit?Perp markets: mark price, 24h change & volume, open interest, funding (1h + annualized APR), max leverage
get_pricecoins?Mid prices for given coins, or all perp mids
get_orderbookcoin, depth?L2 snapshot: best bid/ask, spread %, levels per side
get_candlescoin, interval?, count?OHLCV candles (1m … 1w)
get_accountaddressAccount value, margin usage, withdrawable, every perp position (side, size, entry, liq price, uPnL, leverage), spot balances
get_open_ordersaddressResting orders: side, price, size, type, trigger info
get_recent_fillsaddress, limit?Recent fills: direction, price, size, notional, closed PnL, fees
get_funding_paidaddress, hours?Net funding paid/received per coin over a window

All account tools work on any address — your own, a whale's, a vault's. It's all public on-chain data.

Configuration

Env varDefaultPurpose
HL_INFO_URLhttps://api.hyperliquid.xyz/infoSet to https://api.hyperliquid-testnet.xyz/info for testnet

Development

bash
npm installnpm run buildnpm run smoke   # spawns the server over stdio and exercises every tool against live mainnet

Disclaimer

Read-only market data tooling. Not financial advice; no affiliation with Hyperliquid.

License

MIT

来源：README.md，提交 b2bf5c6

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分