炒作MCP
与Hyperliquit去中心化交换集成的模型上下文协议（MCP）服务器。该服务器使AI代理能够通过记录良好的端点发现Hyperliquit的交易功能并与之交互。
特性
- 查询市场数据和账户信息 -访问实时价格、头寸、余额和订单状态
- 执行现货和永续交易 -通过自动精确处理下达市价单和限价单
- 自动小数精度处理 -无需了解Hyperliquit复杂的十进制规则
- 支持测试网和主网 -在用真实资金交易之前进行安全测试
- 全面的工具文档 -每个工具都包括详细的描述、参数和示例
安装
面向最终用户
直接与 uvx （无需安装）：
uvx hype-mcp第一次运行此命令时， uvx 将自动下载并安装所有依赖项。后续运行将是即时的。
为了发展
# Clone the repository
git clone
cd hype-mcp
# Install dependencies
uv sync
# Run in development mode
uv run hype-mcp配置
MCP设置
在MCP客户端设置中配置服务器（例如，Claude Desktop、Cline）：
{
"mcpServers": {
"hyperliquid": {
"command": "uvx",
"args": ["hype-mcp"],
"env": {
"HYPERLIQUID_PRIVATE_KEY": "0x...",
"HYPERLIQUID_WALLET_ADDRESS": "0x...",
"HYPERLIQUID_TESTNET": "true"
}
}
}
}环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
HYPERLIQUID_PRIVATE_KEY | 是 | - | 您用于签署交易的以太坊私钥（以0x开头） |
HYPERLIQUID_WALLET_ADDRESS | 否 | 来源于私钥 | 您的钱包地址（以0x开头） |
HYPERLIQUID_TESTNET | 没有 | true | 设置为 "true" 对于测试网， "false" 用于主网 |
安全说明：始终从testnet开始(HYPERLIQUID_TESTNET="true")在主网上使用真实资金之前测试您的设置。
可用工具
信息端点工具（只读）
get_account_state
获取您的账户状态，包括头寸、余额和保证金。
参数：
user_address（可选）：要查询的钱包地址。默认为您配置的钱包。
例子：
Get my account state退货：
assetPositions：空缺职位列表crossMarginSummary：账户总价值和杠杆marginSummary：每项资产的保证金明细withdrawable：可提取余额
______________________________________________________________________
get_open_orders
获取所有资产的所有未结订单。
参数：
user_address（可选）：要查询的钱包地址。默认为您配置的钱包。
例子：
Show me my open orders退货： 订单列表：
oid：订单IDcoin：资产符号side：“B”（买入）或“A”（卖出）sz：订单大小px：限价timestamp：订单创建时间
______________________________________________________________________
get_market_data
获取特定资产的当前市场数据。
参数：
symbol（必填）：资产符号（例如，“BTC”、“ETH”、“PURR”）
例子：
What's the current price of BTC?退货：
markPx：当前标价midPx：订单簿中的中等价格prevDayPx：价格24小时前dayNtlVlm：24小时音量funding：资金利率（仅适用于每便士）openInterest：未平仓合约（仅限个人）
______________________________________________________________________
get_all_assets
获取Hyperliquit上所有可用资产的元数据。
例子：
List all available assets退货：
perps：具有杠杆限制的永久合约列表spot：现货资产清单
______________________________________________________________________
Exchange端点工具（交易）
place_spot_order
通过自动小数精度处理下达现货市场订单。服务器 启动时加载spot/perp映射，因此您可以传递规范spot 令牌（例如。， UETH)或熟悉的perp符号（例如。， ETH)MCP将 将订单发送到正确的位置 @index 标识符自动。
参数：
symbol（必填）：现货资产符号（例如“PURR”、“HYPE”）side（必填）：“买入”或“卖出”size（必填）：交易数量（例如1000）price（可选）：限价（限价订单需要）order_type（可选）：“市场”（默认）或“限额”
示例：
Buy 1000 PURR at market price
Sell 500 HYPE at limit price 0.05______________________________________________________________________
place_perp_order
下达具有自动小数精度处理的永久期货订单。
参数：
symbol（必填）：永续符号（例如，“BTC”、“ETH”、“SOL”）side（必填）：“买入”（多头）或“卖出”（空头）size（必填）：头寸大小（例如，0.1 BTC为0.1）leverage（必填）：杠杆倍数（例如，5乘以5）price（可选）：限价（限价订单需要）order_type（可选）：“市场”（默认）或“限额”reduce_only（可选）：如果为真，则只能减少现有位置
示例：
Buy 0.1 BTC with 3x leverage at market price
Sell 1 ETH with 5x leverage at limit price 3500
Close 10 SOL with reduce_only order______________________________________________________________________
cancel_order
取消特定的未结订单。
参数：
symbol（必填）：资产符号order_id（必填）：要取消的订单ID
例子：
Cancel order 123456789 for BTC______________________________________________________________________
cancel_all_orders
取消所有未结订单，可选择按符号筛选。
参数：
symbol（可选）：如果提供，仅取消此符号的订单
示例：
Cancel all my BTC orders
Cancel all my orders______________________________________________________________________
close_position
关闭永久头寸（全部或部分）。
参数：
symbol（必填）：永久符号size（可选）：要关闭的金额。如果没有提供，则关闭整个头寸。
示例：
Close my entire BTC position
Close 0.5 ETH from my position______________________________________________________________________
transfer_wallet_funds
使用以下方式在perp钱包（perp保证金）和现货钱包之间转账USDC 超液体 usdClassTransfer 行动。可用于资助现货采购或 将闲置现货资本转回每股利润。
参数：
amount（必填）：需转账的美元金额（例如150.25）direction（必填）：perp_to_spot将资金转移到现货，或
spot_to_perp 将资金转移回perp钱包
示例：
Move 200 USDC from perp to spot
Move 75 USDC from spot to perp______________________________________________________________________
常见交易场景
场景1：检查账户并下市价单
1. "What's my account state?"
2. "What's the current price of BTC?"
3. "Buy 0.1 BTC with 3x leverage at market price"场景2：下达限价订单并监控
1. "What's the current price of ETH?"
2. "Buy 1 ETH with 5x leverage at limit price 3500"
3. "Show me my open orders"场景3：平仓
1. "What positions do I have open?"
2. "Close my entire SOL position"场景4：现货交易
1. "List all spot assets"
2. "What's the price of PURR?"
3. "Buy 1000 PURR at market price"十进制精度处理
Hyperliquit具有严格的十进制精度规则，这些规则因资产而异。此MCP服务器自动处理所有精度，因此您不必担心细节。
运作原理
尺寸精度：
- 每个资产都有一个
szDecimals值（例如，BTC的3表示0.001是最小大小增量） - 服务器会自动将您的大小四舍五入到正确的精度
- 示例：如果您请求0.12345 BTC
szDecimals=3，变为0.123
价格精度：
- 价格最多只能有5位有效数字
- 价格不能超过
MAX_DECIMALS - szDecimals小数位 - 始终允许整数价格
- 服务器自动验证和格式化价格
这对你意味着什么：
- 只需使用正常的十进制数（例如，0.1、1000、3500.50）
- 服务器处理所有格式化和验证
- 如果存在精度错误，您将收到一条明确的错误消息
故障排除
“需要私钥”
问题： 没有私钥，服务器无法启动。
解决方案： 添加 HYPERLIQUID_PRIVATE_KEY 到您的MCP配置：
"env": {
"HYPERLIQUID_PRIVATE_KEY": "0x..."
}“未找到资产”
问题： 您尝试交易的符号不存在。
解决方案：
- 使用
get_all_assets查看可用资产 - 检查符号拼写是否正确（区分大小写）
- 验证您使用的符号是否正确（例如，“BTC”而不是“BITCOIN”）
“杠杆率超过最大值”
问题： 您要求的杠杆率超过了资产允许的杠杆率。
解决方案：
- 使用
get_all_assets检查maxLeverage为您的资产 - 将杠杆率降低到允许的最大值
- 示例：如果BTC有
maxLeverage: 50，你不能使用100x
“大小精度无效”
问题： 您的资产大小小数位数太多。
解决方案： 这应该会自动处理，但如果您看到此错误：
- 使用
get_all_assets检查资产的szDecimals - 将大小四舍五入到小数点后更少的位置
- 示例：如果
szDecimals=2，使用1.23而不是1.234
“订单被Hyperliquit拒绝”
问题： 交易所拒绝了你的订单。
常见原因：
- 余额不足
- 无效价格（离市场太远）
- 市场暂停
- 超出位置限制
解决方案： 查看错误消息以了解具体细节，并相应地调整您的订单。
连接问题
问题： 无法连接到Hyperliquid API。
解决方案：
- 检查您的互联网连接
- 验证您使用的网络是否正确（测试网与主网）
- 请稍后再试（可能是暂时的API问题）
在测试网上进行测试
始终先在测试网上进行测试！
- 集
HYPERLIQUID_TESTNET="true"在您的配置中 - 从Hyperliquit Discord获取测试网资金
- 测试您的所有交易策略
- 只有当你有信心时才切换到主网
发展
运行测试
# Run all tests
uv run pytest
# Run specific test file
uv run pytest tests/test_tools.py
# Run with verbose output
uv run pytest -v代码质量
# Format code
uv run ruff format .
# Lint code
uv run ruff check .
# Type checking
uv run mypy src/项目结构
hype-mcp/
├── src/hype_mcp/
│ ├── __init__.py
│ ├── __main__.py # Entry point
│ ├── server.py # MCP server setup
│ ├── client_manager.py # Hyperliquid client management
│ ├── decimal_manager.py # Decimal precision handling
│ ├── config.py # Configuration
│ ├── errors.py # Error handling
│ ├── models.py # Data models
│ ├── validation.py # Input validation
│ └── tools/
│ ├── info_tools.py # Read-only tools
│ └── exchange_tools.py # Trading tools
├── tests/
├── pyproject.toml
└── README.md需求
- Python>=3.10
- 用于交易签名的私钥
- 钱包地址（可选，如果未提供，则从私钥派生）
安全最佳实践
- 永远不要共享您的私钥 -保持安全，永远不要将其提交给版本控制
- 先使用测试网 -在使用真实资金之前，始终使用测试网进行测试
- 从小事做起 -从小位置尺寸开始，验证一切正常
- 监控你的位置 -定期检查您的帐户状态和未结订单
- 仅使用reduce\_ -当关闭头寸时，使用
reduce_only=true防止意外打开相反的位置
许可证
麻省理工学院