使用说明
超液体MCP服务器
集成了以下功能的MCP服务器实现 超液体SDK.
📋 先决条件
- Node.js（v22.0.0或更高版本）
- pnpm或纱线包装经理
- 对加密货币交易概念的基本理解
🚀 安装
选项1：从pnpm安装（推荐）
# Install globally
pnpm install -g hyperliquid-mcp
# Or install locally in your project
pnpm install hyperliquid-mcp
选项2：从源代码安装
-
克隆此存储库：
git clone cd hyperliquid-mcp -
安装依赖项：
pnpm install -
构建项目：
pnpm run build
🏗️ 配置
创建一个 .env 使用您的凭据文件：
# This is your wallet private key
PRIVATE_KEY=your_private_key
🔌 使用Claude Desktop
要将此MCP服务器添加到Claude Desktop，请执行以下操作：
-
在以下位置创建或编辑Claude Desktop配置文件：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
- macOS：
-
添加以下配置：
{
"mcpServers": {
"hyperliquid-mcp": {
"command": "node",
"args": ["/path/to/hyperliquid-mcp/dist/index.js"],
"env": {
"PRIVATE_KEY": "your_private_key_here"
},
"disabled": false,
"autoApprove": []
}
}
}
- 重新启动Claude Desktop以使更改生效。
🏃 NPX
{
"mcpServers": {
"hyperliquid-mcp": {
"command": "npx",
"args": ["-y", "hyperliquid-mcp"]
},
"env": {
"PRIVATE_KEY": "your_private_key_here"
}
}
}
🧩 支持的工具
get_spot_learing house_state
获取Hyperliquit上用户的票据交换所状态。
{
user?: string; // User address (optional, defaults to wallet address)
}
对Claude的示例查询：
“显示我的即时帐户状态。”
get_perp_clearinghouse_state
获取用户在Hyperliquit上的永久票据交换所状态。
{
user?: string; // User address (optional, defaults to wallet address)
}
对Claude的示例查询：
“显示我的罪犯账户状态。”
获取订单状态
获取特定订单的状态。
{
user: string; // User address
oid: number | string; // Order ID
}
对Claude的示例查询：
“检查我的钱包订单：o123456状态”
get_open_orders
获取用户的所有未结订单。
{
user?: string; // User address (optional, defaults to wallet address)
}
对Claude的示例查询：
“检查我所有的未结订单”
获取订单历史
获取用户的订单历史记录。
{
user?: string; // User address (optional, defaults to wallet address)
}
对Claude的示例查询：
“检查我的帐户订单历史记录”
get_all_mids
获取Hyperliquit上所有硬币的中间价格。
get_spot_data
请求现货交易元数据。
get_handle_snapshot
获取历史烛台数据。
{
coin: string; // Token symbol, e.g. "BTC"
interval: string; // Time interval, e.g. "15m", "1h", "4h", "1d"
startTime: number; // Start timestamp in milliseconds
endTime?: number; // End timestamp in milliseconds (optional)
}
get_l2_book
获取L2订单簿数据。
{
coin: string; // Token symbol, e.g. "BTC-PERP", "ETH-PERP", "SOL-PERP", "BTC-SPOT"
}
下单
下达交易订单。
{
coin: string; // Token symbol
is_buy: boolean; // true for buy, false for sell
sz: number; // Order size
limit_px: number; // Limit price
tif?: "Gtc" | "Ioc" | "Alo"; // Time-in-force (optional)
reduce_only?: boolean; // Reduce-only flag (optional)
vaultAddress?: string; // Vault address (optional)
is_limit?: boolean; // Limit order flag (optional)
trigger_px?: number; // Trigger price (optional)
is_market?: boolean; // Market order flag (optional)
tpsl?: "tp" | "sl"; // Take-profit/Stop-loss type (optional)
}
对Claude的示例查询：
“创建一个10美元的HYPE限价订单，并将目标价格设置为20美元”
取消订单
取消现有订单。
{
coin: string; // Token symbol
o: number; // Order ID
}
对Claude的示例查询：
“取消我们之前创建的订单”
transfer_spot_perp
即期账户和永续账户之间的转账。
{
amount: number; // Transfer amount
to_perp: boolean; // true for transfer to perpetual, false for transfer to spot
}
对Claude的示例查询：
“从现场转移10美元给罪犯”
响应格式
每个工具返回一个Promise，其解析方式为：
- 成功：返回相应的数据对象
- 失败：抛出错误并显示错误消息
注意：所有数值参数都接受数字和字符串输入。系统将根据需要自动处理类型转换。
🔐 安全考虑
- 私钥保护：切勿公开或硬编码您的私钥。使用环境变量。
- 考虑使用环境变量或安全凭证管理器，而不是硬编码敏感信息。
- 在转移资金或部署合约时要小心，因为这些操作在区块链上是不可逆转的。
- 使用入口功能时，请确保您处于安全连接状态。
- 在确认之前，请核实所有交易细节，特别是在转账或购买信用时。
📷 故障排除
如果您遇到问题：
- 验证您的钱包私钥是否有效
- 检查Claude Desktop日志中是否有任何错误消息
📖 许可证
此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。
🤝 贡献
欢迎投稿！请随时提交拉取请求。
有关为Hyperliquit MCP做出贡献的详细指南，包括：
- 报告错误
- 建议增强功能
- 开发设置
- 编码标准
- 添加工具
- 测试要求
- 文件标准
基本贡献步骤：
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
请确保您的代码遵循现有样式并包含适当的测试。
内置于❤️ Impa Ventures
