Hyperliquid MCP，适用于 HL Coder

此仓库包含一个用于 Hyperliquid 的模型上下文协议 (MCP) 服务器，该服务器与 HL Coder 集成。它允许您在 HL Coder 中通过自然语言与 Hyperliquid 交互。

快速开始

要安装和运行 Hyperliquid MCP 服务器，只需在 HL Coder 中运行以下命令：

curl -s https://raw.githubusercontent.com/TradingBalthazar/hyperliquid-mcp-v2/main/install-and-run.sh | bash

这将：

1. 下载并安装必要的文件
2. 安装所需的依赖项
3. 启动 Hyperliquid MCP 服务器
4. 在您的浏览器中打开一个仪表板以输入您的凭据

功能

• 使用您的密钥连接到 Hyperliquid
• 获取市场数据（价格、订单簿等）
• 获取用户数据（仓位、账户价值等）
• 下单和取消订单
• 更新杠杆

设置

1. 在 HL Coder 中运行安装命令
2. 当仪表板在您的浏览器中打开时，输入您的 Hyperliquid 密钥
3. (可选) 输入您的 Ethereum 账户地址
4. 选择网络（主网或测试网）
5. 点击 "Connect to Hyperliquid"

示例命令

连接后，您可以使用自然语言在 HL Coder 中与 Hyperliquid 交互。以下是一些示例：

• "Get current market prices for all coins" (获取所有币种的当前市场价格)
• "Show my current positions and account value" (显示我当前的仓位和账户价值)
• "Place a limit buy order for 0.1 BTC at $60,000" (以 60,000 美元的价格下达 0.1 BTC 的限价买单)
• "Cancel all my open orders for ETH" (取消我所有 ETH 的未结订单)
• "Update my leverage for BTC to 5x" (将我的 BTC 杠杆更新为 5 倍)

可用工具

Hyperliquid MCP 服务器提供以下工具：

get_market_data

从 Hyperliquid 获取市场数据。

参数：

• dataType: 要检索的市场数据类型 (all_mids, l2_snapshot, meta, meta_and_asset_ctxs, spot_meta, spot_meta_and_asset_ctxs, candles, funding_history)
• coin: 币种符号 (l2_snapshot, candles, funding_history 必需)
• interval: K 线图间隔 (candles 必需)
• startTime: 开始时间，以毫秒为单位 (candles, funding_history 必需)
• endTime: 结束时间，以毫秒为单位 (candles, funding_history 可选)

get_user_data

从 Hyperliquid 获取用户特定数据。

参数：

• dataType: 要检索的用户数据类型 (user_state, spot_user_state, open_orders, frontend_open_orders, user_fills, user_fills_by_time, user_funding_history, user_fees, user_staking_summary, user_staking_delegations, user_staking_rewards, query_sub_accounts)
• startTime: 开始时间，以毫秒为单位 (user_fills_by_time, user_funding_history 必需)
• endTime: 结束时间，以毫秒为单位 (user_fills_by_time, user_funding_history 可选)

place_limit_order

在 Hyperliquid 上下达限价单。

参数：

• coin: 币种符号
• isBuy: 订单是否为买单
• size: 订单大小
• price: 订单价格
• timeInForce: 有效时间 (Gtc, Ioc, Alo)
• reduceOnly: 订单是否为只减仓
• clientOrderId: 客户端订单 ID

place_market_order

在 Hyperliquid 上下达市价单。

参数：

• coin: 币种符号
• isBuy: 订单是否为买单
• size: 订单大小
• slippage: 滑点容忍度 (默认: 0.05)
• clientOrderId: 客户端订单 ID

cancel_order

取消 Hyperliquid 上的订单。

参数：

• coin: 币种符号
• orderId: 订单 ID
• clientOrderId: 客户端订单 ID

update_leverage

更新币种的杠杆。

参数：

• coin: 币种符号
• leverage: 杠杆值
• isCross: 是否使用逐仓保证金 (默认: true)

可用资源

Hyperliquid MCP 服务器提供以下资源：

• hyperliquid://market/all-mids: 所有币种的当前中间价
• hyperliquid://market/l2-book/{coin}: 特定币种的 L2 订单簿
• hyperliquid://user/{address}/state: 特定地址的用户状态
• hyperliquid://user/{address}/open-orders: 特定地址的未结订单

安全

您的密钥存储在本地，仅用于向 Hyperliquid 验证身份。它永远不会发送到任何第三方服务器。

要求

• Node.js 14+
• Python 3.6+
• pip (用于安装 Python 依赖项)

许可证

MIT