hyperliquid-whalealert-mcp

🚀 Hyperliquid鲸鱼警报MCP

Hyperliquid鲸鱼警报MCP是一个MCP服务器，它能在Hyperliquid上提供实时的鲸鱼警报，标记出名义价值超过100万美元的头寸。

✨ 主要特性

• 工具：get_whale_alerts：获取近期的鲸鱼交易数据，并使用pandas将其以Markdown表格的形式返回，格式清晰。
• 提示词：summarize_whale_activity：生成鲸鱼交易的摘要，包括总头寸价值和显著交易符号等指标。

📦 安装指南

环境要求

• Python：版本3.10或更高。
• CoinGlass API密钥：可从CoinGlass获取（API访问必需）。
• uv：包和依赖管理工具（安装uv）。

安装步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/hyperliquid-whalealert-mcp.git
   cd hyperliquid-whalealert-mcp
   

2. 安装依赖：

   uv sync
   

   此命令将安装pyproject.toml中指定的依赖项。

3. 集成到Claude桌面端： 可以使用以下命令在Claude桌面端安装服务器：

   uv run mcp install mcp.py --name "Hyperliquid Whale Alert"
   

   或者手动更新配置文件：

   {
     "mcpServers": {
       "hyperliquid-whalealert": {
         "command": "uv",
         "args": [ "--directory", "/path/to/hyperliquid-whalealert-mcp", "run", "main.py" ],
         "env": { "COINGLASS_API_KEY": "your_api_key" }
       }
     }
   }
   

   请将/path/to/hyperliquid-whalealert-mcp替换为实际的安装路径，并将COINGLASS_API_KEY替换为你的API密钥。

💻 使用示例

基础用法

使用工具

get_whale_alerts工具可获取鲸鱼交易数据，并以Markdown列表的形式返回。示例输出如下：

- **ETH交易**：
  - 用户地址：0x3fd4444154242720c0d0c61c74a240d90c127d33
  - 头寸规模：12700
  - 入场价格：$1611.62
  - 清算价格：$527.2521
  - 头寸价值（美元）：$21003260
  - 操作：平仓
  - 创建时间：2025-05-20 12:31:57
- **BTC交易**：
  - 用户地址：0x1cadadf0e884ac5527ae596a4fc1017a4ffd4e2c
  - 头寸规模：33.54032
  - 入场价格：$87486.2
  - 清算价格：$44836.8126
  - 头寸价值（美元）：$2936421.4757
  - 操作：平仓
  - 创建时间：2025-05-20 12:31:17

调用该工具的方法如下：

• 在MCP检查器中，选择get_whale_alerts并执行。
• 在Claude桌面端，使用已注册的服务器，通过UI或API调用该工具。

使用提示词

summarize_whale_activity提示词可生成鲸鱼交易的摘要。在兼容的客户端中的示例交互如下：

/summarize_whale_activity

响应如下：

我将分析鲸鱼交易数据并提供摘要。

大语言模型可以进一步扩展此功能，提供总头寸价值或显著交易符号等详细指标。

📄 许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。