hyperliquid-mcp

hyperliquid-mcp

让你的 AI Agent 洞察 Hyperliquid。 这是一个轻量、只读的 MCP 服务，可让 Claude（或任何兼容 MCP 的 Agent）查询 Hyperliquid 永续市场、资金费率、订单簿、K 线，以及任意地址的持仓、成交和资金费。

• 🔑 无需 API 密钥、钱包或签名——只使用公开的 Info API。它永远无法进行交易。
• 📦 零配置——在 MCP 配置中添加一项即可。
• 🪶 轻量——两个源文件、两个依赖（MCP SDK + zod）。

快速开始

Claude Code

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

Claude Desktop / Cursor / 任意 MCP 客户端

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

从源码运行

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

你可以询问

“Hyperliquid 上目前最极端的资金费率是什么？”

“显示 0xabc… 的未平仓持仓和强平价格——它离强平还有多远？”

“过去一周，我的账户按币种支付了多少资金费？”

“获取 HYPE 的 4h K 线并描述趋势。”

工具

工具	参数	返回内容
get_markets	coin?、sortBy?（volume · funding · change · openInterest）、limit?	永续市场：标记价格、24h 涨跌幅和成交量、未平仓合约、资金费率（1h + 年化 APR）、最大杠杆
get_price	coins?	指定币种的中间价，或所有永续合约的中间价
get_orderbook	coin、depth?	L2 快照：最佳买价/卖价、价差百分比、每侧档位
get_candles	coin、interval?、count?	OHLCV K 线（1m … 1w）
get_account	address	账户价值、保证金使用量、可提现金额、每个永续持仓（方向、规模、入场价、强平价、未实现盈亏、杠杆）、现货余额
get_open_orders	address	挂单：方向、价格、规模、类型、触发信息
get_recent_fills	address、limit?	最近成交：方向、价格、规模、名义价值、已实现盈亏、手续费
get_funding_paid	address、hours?	指定时间段内按币种统计的净资金费支付/收入

所有账户工具都适用于任意地址——你自己的、巨鲸的或金库的。这些都是公开的链上数据。

配置

环境变量	默认值	用途
HL_INFO_URL	https://api.hyperliquid.xyz/info	测试网环境下设为 https://api.hyperliquid-testnet.xyz/info

开发

npm install
npm run build
npm run smoke   # spawns the server over stdio and exercises every tool against live mainnet

免责声明

只读市场数据工具。不构成财务建议；与 Hyperliquid 无关联。

许可证

MIT