Hyperliquid MCP Server - Complete Implementation
2025.04.14
0
JavaScript交易服务加密货币金融工具金融服务
Hyperliquid MCP Server 是一个全面的模型上下文协议服务器，为 Hyperliquid SDK 提供了完整的封装，使 AI 助手能够与 Hyperliquid 交易所进行交互，包括获取市场数据、执行交易、管理头寸等功能。该服务器支持现货和期货市场的交易，并提供了全面的 API 覆盖，包括市场数据检索、订单管理、头寸管理、账户信息、资金转移等功能。
View on GitHub
Overview
基本能力
产品定位
Hyperliquid MCP Server 是一个为 AI 助手设计的交易工具，提供与 Hyperliquid 交易所的全面交互能力，包括市场数据获取、订单执行、头寸管理等。
核心功能
- 市场数据检索：获取价格、订单簿、蜡烛图等市场数据。
- 订单管理：支持市价单、限价单、触发单、TWAP 订单的放置和管理。
- 头寸管理：调整杠杆、保证金、平仓等操作。
- 账户信息：获取账户余额、持仓、开单等信息。
- 资金转移：支持 USDC 转账、提现、现货资产转移等。
- 金库管理：创建和管理金库，进行资金分配和转移。
- 子账户管理：创建和管理子账户，进行资金转移。
适用场景
- 自动化交易：AI 助手可以自动化执行交易策略。
- 市场分析：获取实时市场数据进行分析。
- 账户管理：管理账户资金、持仓和订单。
- 金库操作：进行金库的创建、资金分配和转移。
工具列表
- 市场数据工具：
getMarketPrice,getOrderBook,getCandleData,getAllMids。 - 账户信息工具：
getAccountInfo,getSpotAccountInfo,getUserOpenOrders,getUserFills。 - 订单管理工具：
placeMarketOrder,placeLimitOrder,placeTriggerOrder,placeTwapOrder。 - 头寸管理工具：
updateLeverage,updateIsolatedMargin,closePosition,closeAllPositions。 - 资金转移工具：
usdTransfer,initiateWithdrawal,spotTransfer,transferBetweenSpotAndPerp。 - 金库管理工具：
createVault,getVaultDetails,vaultTransfer,vaultDistribute。 - 子账户管理工具：
createSubAccount,getSubAccounts,subAccountTransfer,subAccountSpotTransfer。
常见问题解答
- 如何保护私钥安全：私钥提供对资金的完全访问权限，切勿公开或共享。
- 如何使用测试网络：在测试网络上测试配置后再使用主网。
- 如何处理市场订单：市场订单通过带有滑点的限价单实现。
使用教程
使用依赖
- Node.js (v14 或更高版本)
- Hyperliquid 账户
- 以太坊私钥（用于交易认证）
- 钱包地址（用于交易）
安装教程
- 克隆或下载项目代码。
- 安装依赖：
npm install
- 配置环境变量或创建
.hyperliquid-config.json文件。 - 启动服务器：
node hyperliquid-mcp-server-complete.js
调试方式
- 设置
LOG_LEVEL环境变量为debug以获取详细日志。 - 使用测试网络进行初步测试。
- 检查服务器日志以排查问题。
安全考虑
- 私钥安全：确保私钥不被泄露。
- 测试网络优先：先在测试网络上测试所有操作。
- 限制访问：仅允许受信任的 AI 助手和应用程序访问 MCP 服务器。
免责声明
加密货币交易涉及重大风险。本工具仅用于教育和信息目的。在交易前务必了解风险，切勿使用无法承受损失的资金进行交易。