HyperLiquid MCP Server¶

基于 FastMCP 的 HyperLiquid 交易 MCP 服务器。为 AI 助手提供与 HyperLiquid 永续合约和现货交易平台交互的工具。

本项目 Fork 自 GigabrainGG/hyperliquid-mcp，感谢原作者的出色工作！

✨ 主要功能¶

🚀 交易工具¶

• 市价订单：使用 HyperLiquid 原生函数优化的开仓和平仓
• 限价订单：支持 reduce-only 和自定义订单 ID 追踪
• 括号订单：一键创建带止盈止损的新仓位（OCO 行为）
• 订单管理：按 ID 或客户端 ID 取消订单、批量取消、修改订单
• 仓位管理：查看仓位、平仓（全部或部分）、获取盈亏信息
• 高级止盈止损：为现有仓位设置 OCO 止盈止损

📊 账户管理¶

• 余额信息：获取账户余额和保证金详情
• 仓位跟踪：监控所有开仓及未实现盈亏
• 交易历史：查询成交记录和交易历史
• 杠杆控制：为不同资产更新杠杆设置
• 资金划转：在现货和合约账户间转移资金

📈 市场数据¶

• 实时价格：获取当前市场数据，包括买卖价差
• 订单簿：获取可配置深度的实时订单簿数据
• 资金费率：访问历史资金费率信息

🛠️ 实用工具¶

• 账户总览：获取账户综合概览
• 美元转换：根据当前价格计算代币数量
• 仓位管理：专用的现有仓位管理工具

🎯 快速开始¶

# 查看帮助
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

# 克隆仓库
git clone https://github.com/talkincode/hyperliquid-mcp-python.git
cd hyperliquid-mcp-python

# 安装依赖
uv sync

# 配置
cp .env.example .env  # 然后编辑 .env 文件

# 运行
uv run hyperliquid-mcp              # HTTP 模式
uv run hyperliquid-mcp stdio        # stdio 模式

# 使用 pip（需要 Python 3.10-3.13）
pip install hyperliquid-mcp-python

# 运行
hyperliquid-mcp --help

📚 文档导航¶

⚠️ 重要提示¶

!!! warning "安全建议" - 绝不提交包含私钥的 .env 文件 - 强烈建议先使用测试网进行测试 - 建议使用 API 钱包：https://app.hyperliquid.xyz/API

加密货币交易涉及重大风险。本项目仅供学习使用，请谨慎使用真实资金。

🔗 相关链接¶

• HyperLiquid 文档
• FastMCP
• MCP 协议
• GitHub 仓库
• PyPI 包

📄 许可证¶

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。