一个MCP服务器,提供超液态,旗下位置的实时鲸鱼警报,其名义价值超过一百万美元.

□ 特性

• ** 工具:[[T0]**: 获取最近的鲸鱼交易,并用 pandas 进行清洁格式化的标记表返回。
• ** 进展:summarize_whale_activity**: 生成鲸鱼交易摘要,包括总位置值和显著符号等度量.

□ 先决条件

• ** Python**:版本3.10或更高。
• CoinGlass API密钥:从CoinGlass获取(API访问需要).
• uv:包裹和抚养管理人(安装uv)。

□ 安装

1. ** 仓库单位**:

2. ** 安置依赖**:

此安装在 [[T3] 中指定的依赖 。

3. Claude桌面集成: 在 Claude 桌面上安装服务器 :

或者手动更新配置文件 :

将 /path/to/hyperliquid-whalealert-mcp 替换为您的实际安装路径,并将 [[T5] 替换为您的 API 密钥。

□ 使用量

使用工具

[T6] 工具获取鲸鱼交易数据并作为Markdown列表返回. 示例输出 :

使用该工具:

Hyperliquid WhaleAlert MCP

An MCP server that provides real-time whale alerts on Hyperliquid, flagging positions with a notional value exceeding $1 million.

Features

• Tool: get_whale_alerts: Fetches recent whale transactions and returns them as a Markdown table using pandas for clean formatting.
• Prompt: summarize_whale_activity: Generates a summary of whale transactions, including metrics like total position value and notable symbols.

Prerequisites

• Python: Version 3.10 or higher.
• CoinGlass API Key: Obtain from CoinGlass (required for API access).
• uv: Package and dependency manager (install uv).

Installation

1. Clone the Repository:

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

2. Install Dependencies:

   uv sync
   

   This installs dependencies specified in pyproject.toml.

3. Claude Desktop Integration: Install the server in Claude Desktop:

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

   Or update the configuration file manually:

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

   Replace /path/to/hyperliquid-whalealert-mcp with your actual installation path and COINGLASS_API_KEY with your API key.

Usage

Using the Tool

The get_whale_alerts tool fetches whale transaction data and returns it as a Markdown list. Example output:

- **ETH Transaction**:
  - User Address: 0x3fd4444154242720c0d0c61c74a240d90c127d33
  - Position Size: 12700
  - Entry Price: $1611.62
  - Liquidation Price: $527.2521
  - Position Value (USD): $21003260
  - Action: Close
  - Create Time: 2025-05-20 12:31:57
- **BTC Transaction**:
  - User Address: 0x1cadadf0e884ac5527ae596a4fc1017a4ffd4e2c
  - Position Size: 33.54032
  - Entry Price: $87486.2
  - Liquidation Price: $44836.8126
  - Position Value (USD): $2936421.4757
  - Action: Close
  - Create Time: 2025-05-20 12:31:17

To invoke the tool:

• In the MCP Inspector, select get_whale_alerts and execute.
• In Claude Desktop, use the registered server and call the tool via the UI or API.

Using the Prompt