hyperliquid-mcp-python

# HyperLiquid MCP Server [](https://github.com/talkincode/hyperliquid-mcp-python/actions/workflows/ci.yml) [](https://badge.fury.io/py/hyperliquid-mcp-python) [](https://pypi.org/project/hyperliquid-mcp-python/) [](https://opensource.org/licenses/MIT) 基于 FastMCP 的 HyperLiquid 交易 MCP 服务器。为 AI 助手提供与 HyperLiquid 永续合约和现货交易平台交互的工具。 > **致谢**: 本项目 Fork 自 [GigabrainGG/hyperliquid-mcp](https://github.com/GigabrainGG/hyperliquid-mcp)，感谢原作者的出色工作！ ## 功能特性 ### 交易工具 - [x] **市价订单**：使用 HyperLiquid 原生函数优化的开仓和平仓 - [x] **限价订单**：支持 reduce-only 和自定义订单 ID 追踪 - [x] **括号订单**：一键创建带止盈止损的新仓位（OCO 行为） - [x] **订单管理**：按 ID 或客户端 ID 取消订单、批量取消、修改订单 - [x] **仓位管理**：查看仓位、平仓（全部或部分）、获取盈亏信息 - [x] **高级止盈止损**：为现有仓位设置 OCO 止盈止损 ### 账户管理 - [x] **余额信息**：获取账户余额和保证金详情 - [x] **仓位跟踪**：监控所有开仓及未实现盈亏 - [x] **交易历史**：查询成交记录和交易历史 - [x] **杠杆控制**：为不同资产更新杠杆设置 - [x] **资金划转**：在现货和合约账户间转移资金 ### 市场数据 - [x] **实时价格**：获取当前市场数据，包括买卖价差 - [x] **订单簿**：获取可配置深度的实时订单簿数据 - [x] **资金费率**：访问历史资金费率信息 ### 实用工具 - [x] **账户总览**：获取账户综合概览 - [x] **美元转换**：根据当前价格计算代币数量 - [x] **仓位管理**：专用的现有仓位管理工具 ## 快速开始 ### 方式 1：使用 uvx（推荐）🚀 **最简单的方式** - 无需安装，直接运行： ```bash # 查看帮助 uvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp --help # 启动 HTTP 服务器 uvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp start # 启动 stdio 服务器（用于 MCP 客户端） uvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp stdio ``` > **为什么要指定 `--python 3.13`?** > 依赖包 `ckzg` 目前只提供到 Python 3.13 的预编译包，Python 3.14 还不支持。指定版本可以避免编译错误。 ### 方式 2：本地开发安装 ```bash # 克隆仓库 git clone https://github.com/talkincode/hyperliquid-mcp-python.git cd hyperliquid-mcp-python # 安装依赖（uv 会自动处理编译） uv sync # 配置 cp .env.example .env # 然后编辑 .env 文件 # 或设置环境变量 export H…