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

響應如下：

我將分析鯨魚交易數據並提供摘要。

大語言模型（LLMs）可擴展此功能，以提供總頭寸價值或顯著符號等詳細指標。

📄 許可證

本項目採用MIT許可證。有關詳細信息，請參閱LICENSE文件。