Hyperliquid MCP Server
2025.03.25
0
TypeScript加密货币交易Hyperliquid 集成金融服务
Hyperliquid MCP Server 是一个基于 Hyperliquid SDK 实现的 MCP 服务器，主要用于加密货币交易相关的操作。它提供了多种工具来查询和操作 Hyperliquid 平台上的交易数据，包括现货和永续合约的清算状态、订单状态、历史数据等。
View on GitHub
Overview
基本能力
产品定位
Hyperliquid MCP Server 是一个专注于加密货币交易的 MCP 服务器，提供了与 Hyperliquid 平台交互的工具集。
核心功能
- 查询现货和永续合约的清算状态
- 查询订单状态和历史数据
- 获取市场价格和订单簿数据
- 下单和取消订单
- 现货和永续合约之间的资金转移
适用场景
- 加密货币交易者需要快速查询账户状态和订单信息
- 开发者需要集成 Hyperliquid 平台的交易功能
- 自动化交易系统需要与 Hyperliquid 平台交互
工具列表
- get_spot_clearinghouse_state: 查询用户的现货清算状态
- get_perp_clearinghouse_state: 查询用户的永续合约清算状态
- get_order_status: 查询特定订单的状态
- get_open_orders: 查询用户的所有未成交订单
- get_order_history: 查询用户的订单历史
- get_all_mids: 获取所有币种的市场中间价
- get_spot_meta: 获取现货交易元数据
- get_candle_snapshot: 获取历史K线数据
- get_l2_book: 获取L2订单簿数据
- place_order: 下单
- cancel_order: 取消订单
- transfer_spot_perp: 现货和永续合约之间的资金转移
常见问题解答
- 问题1: 如何保护私钥？
- 解答: 使用环境变量存储私钥，避免硬编码。
- 问题2: 遇到问题如何排查？
- 解答: 检查私钥是否有效，查看 Claude Desktop 的日志。
使用教程
使用依赖
- Node.js (v22.0.0 或更高版本)
- pnpm 或 yarn 包管理器
安装教程
选项1: 通过 pnpm 安装（推荐）
# 全局安装
pnpm install -g hyperliquid-mcp
# 或在项目中本地安装
pnpm install hyperliquid-mcp
选项2: 从源码安装
- 克隆仓库:
git clone
cd hyperliquid-mcp
- 安装依赖:
pnpm install
- 构建项目:
pnpm run build
调试方式
- 创建
.env文件并添加私钥:
PRIVATE_KEY=your_private_key
- 运行服务器并检查日志。