Hyperliquid MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，包装 Hyperliquid SDK，为 AI 助手提供加密货币交易功能。

概述

该 MCP 服务器使 AI 助手能够与 Hyperliquid 交易所交互，以检索市场数据、执行交易、管理仓位等。它实现了模型上下文协议 (MCP)，以提供全方位的交易功能。

特征

完整实现所有 Hyperliquid SDK API，用于现货和期货交易
市场数据检索（价格、订单簿、K线图）
订单下达及管理（市价、限价、触发、TWAP）
头寸管理（杠杆、保证金、平仓）
账户信息和余额
资金费率信息
转账和提款
保险库管理
子账户管理
推荐系统集成

技术特点

使用私钥和钱包地址进行正确的身份验证
全面的错误处理和验证
实时市场数据访问
支持客户订单 ID（cloud）以进行订单跟踪
支持测试网和主网

先决条件

Node.js（v14 或更高版本）
超流动性账户
用于身份验证的以太坊私钥（交易所需）
您的钱包地址（交易所需）

安装

# Clone the repository
git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server.git

# Navigate to the project directory
cd hyperliquid-mcp-server

# Install dependencies
npm install

配置

可以使用环境变量或配置文件来配置服务器：

环境变量

HYPERLIQUID_PRIVATE_KEY ：用于身份验证的以太坊私钥（交易所需）
HYPERLIQUID_WALLET_ADDRESS ：您的钱包地址（交易所需）
HYPERLIQUID_VAULT_ADDRESS ：您的保险库地址（可选，用于保险库操作）
HYPERLIQUID_TESTNET ：设置为“true”表示使用测试网，设置为“false”表示使用主网（默认值：false）
LOG_LEVEL ：日志级别 - ‘debug’、‘info’、‘warn’ 或 ‘error’（默认值：‘info’）

配置文件

您还可以在与服务器相同的目录中创建一个.hyperliquid-config.json文件，其结构如下：

{
  "privateKey": "your-ethereum-private-key",
  "walletAddress": "your-wallet-address",
  "vaultAddress": "your-vault-address",
  "testnet": false,
  "logLevel": "info",
  "popularCoins": ["BTC", "ETH", "SOL", "AVAX", "ARB", "DOGE", "LINK", "MATIC"]
}

用法

通过运行以下命令启动服务器：

npm start

或者运行演示客户端：

npm run demo

可用工具

该服务器提供了一套全面的工具，用于与 Hyperliquid 交易所进行交互。以下是一些示例：

市场数据工具

getMarketPrice ：获取指定加密货币的当前价格
getOrderBook ：获取指定加密货币的当前订单簿
getCandleData ：获取指定加密货币的历史蜡烛数据
getAllMids ：获取所有可用加密货币的中间价格

帐户信息工具

getAccountInfo ：获取用户永续合约账户信息
getSpotAccountInfo ：获取用户现货交易账户信息
getUserOpenOrders ：获取用户所有未结订单
getUserFills ：获取用户最近的填充

订单管理工具

placeMarketOrder ：为指定的加密货币下达市场订单
placeLimitOrder ：针对指定加密货币下限价订单
placeTriggerOrder ：下达触发订单（止损或止盈）
placeTwapOrder ：下达 TWAP（时间加权平均价格）订单
cancelOrder ：取消现有订单
cancelOrderByCloid ：根据客户订单ID取消订单
cancelAllOrders ：取消所有未结订单
modifyOrder ：修改现有订单

安全注意事项

私钥安全：您的以太坊私钥将提供对您资金的完全访问权限。切勿将其与他人共享或在公共存储库中暴露。
首先使用测试网：在主网上使用真实资金之前，请务必在测试网上测试您的设置。
限制访问：限制受信任的 AI 助手和应用程序对 MCP 服务器的访问。

免责声明

加密货币交易涉及高风险。本工具仅供教育和信息参考之用。交易前请务必了解相关风险，切勿使用您无法承受损失的资金进行交易。

执照

麻省理工学院

Hyperliquid MCP Server

Integrations