鲸鱼交易实时警报服务

Hyperliquid WhaleAlert MCP是一个实时监控并报告大额交易(超过100万美元)的服务器,适用于加密货币交易监控和分析。

  • by kukapay
  • Python
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 kukapay/hyperliquid-whalealert-mcp

使用说明

超液态鲸鱼警报MCP

一个MCP服务器,在Hyperliquit上提供实时鲸鱼警报,标记名义价值超过100万美元的位置。

特性

  • 工具: get_whale_alerts:获取最近的whale交易,并使用Markdown表将其返回 pandas 用于干净的格式。
  • 提示: summarize_whale_activity:生成鲸鱼交易的摘要,包括总头寸价值和显著符号等指标。

先决条件

  • python:版本3.10或更高版本。
  • CoinGlass API密钥:从获取 币海 (API访问需要)。
  • 紫外线:包和依赖关系管理器(安装uv).

安装

  1. 克隆存储库:

    git clone https://github.com/kukapay/hyperliquid-whalealert-mcp.git
    cd hyperliquid-whalealert-mcp
    
  2. 再进行:

    uv sync
    

    这将安装中指定的依赖项 pyproject.toml.

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

    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 该工具获取whale交易数据并将其作为Markdown列表返回。输出示例:

- **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

要调用该工具,请执行以下操作:

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

使用提示

这 summarize_whale_activity prompt生成whale交易的摘要。交互示例(在兼容客户端中):

/summarize_whale_activity

答复:

I'll analyze the whale transaction data and provide a summary.

LLM可以扩展此功能,以提供详细的度量,如总位置值或显著符号。

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。