Hyperliquid MCP 服务器

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

概述

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

功能

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

技术特性

• 使用私钥和钱包地址进行正确的身份验证
• 完善的错误处理和验证
• 实时市场数据访问
• 支持客户端订单 ID (cloid) 以进行订单跟踪
• 支持测试网和主网

前提条件

• Node.js (v14 或更高版本)
• 一个 Hyperliquid 账户
• 用于身份验证的以太坊私钥（交易必需）
• 您的钱包地址（交易必需）

安装

# 克隆仓库
git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server.git

# 导航到项目目录
cd hyperliquid-mcp-server

# 安装依赖
npm install

配置

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

环境变量

• HYPERLIQUID_PRIVATE_KEY: 您的以太坊私钥，用于身份验证（交易必需）
• HYPERLIQUID_WALLET_ADDRESS: 您的钱包地址（交易必需）
• HYPERLIQUID_VAULT_ADDRESS: 您的 vault 地址（可选，用于 vault 操作）
• 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: 获取指定加密货币的历史 K 线数据
• getAllMids: 获取所有可用加密货币的所有中间价

账户信息工具

• getAccountInfo: 获取有关用户永续期货账户的信息
• getSpotAccountInfo: 获取有关用户现货交易账户的信息
• getUserOpenOrders: 获取用户的所有未结订单
• getUserFills: 获取用户最近的成交记录

订单管理工具

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

安全注意事项

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

免责声明

交易加密货币涉及重大风险。此工具仅用于教育和信息目的。在交易之前，请务必了解所涉及的风险，并且永远不要用您无法承受损失的资金进行交易。

许可证

MIT