内容
# hyperliquid-mcp
**为您的AI代理提供Hyperliquid的眼睛。** 一个小型、只读的 [MCP](https://modelcontextprotocol.io) 服务器，允许Claude（或任何MCP兼容代理）查询Hyperliquid永续合约市场、资金费率、订单簿、蜡烛图 — 以及 **任何** 地址的仓位、成交记录和资金费。
- 🔑 **无需API密钥，无需钱包，无需签名** — 仅使用公共信息API。它永远无法交易。
- 📦 **零配置** — 在您的MCP配置中添加一行即可完成。
- 🪶 **极小** — 仅有两个源文件和两个依赖项（MCP SDK + zod）。
## 快速开始
### Claude 代码
```bash
claude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcp
```
### Claude 桌面版 / Cursor / 任何MCP客户端
```json
{
"mcpServers": {
"hyperliquid": {
"command": "npx",
"args": ["-y", "@kitsune-de/hyperliquid-mcp"]
}
}
}
```
### 从源码构建
```bash
git clone https://github.com/kitsune-de/hyperliquid-mcp
cd hyperliquid-mcp && npm install && npm run build
# 然后将您的MCP客户端指向：node /path/to/hyperliquid-mcp/dist/index.js
```
## 您可以使用以下问题
> *"Hyperliquid当前的资金费率最高的市场有哪些？"*
>
> *"显示0xabc…的当前仓位和清算价格 — 它距离清算有多近？"*
>
> *"我的账户在过去一周内按币种计算的资金费用是多少？"*
>
> *"拉取HYPE的4小时蜡烛图并描述趋势。"*
## 工具
| 工具 | 参数 | 返回值 |
| --- | --- | --- |
| `get_markets` | `coin?`, `sortBy?` （交易量 · 资金费率 · 变化 · 开仓兴趣）, `limit?` | 永续合约市场: 标记价格, 24小时变化和交易量, 开仓兴趣, 资金费率（1小时 + 年化APR）, 最大杠杆 |
| `get_price` | `coins?` | 给定币种的中间价，或所有永续合约中间价 |
| `get_orderbook` | `coin`, `depth?` | L2快照: 最佳买入/卖出价, 价差%, 每侧的订单数量 |
| `get_candles` | `coin`, `interval?`, `count?` | OHLCV蜡烛图（1分钟 … 1周） |
| `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` 以使用测试网 |
## 开发
```bash
npm install
npm run build
npm run smoke # 通过标准输入输出启动服务器，并针对主网上的每个工具进行测试
```
## 免责声明
只读市场数据工具。不是财务建议；与Hyperliquid无关联。
## 许可证
MIT
