hyperliquid-whalealert-mcp

Hyperliquid WhaleAlert MCP 是一个 MCP（Model Context Protocol）服务器，旨在为 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 中指定的依赖。

集成到 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 密钥。

调用工具

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

使用提示词

summarize_whale_activity 提示词可生成巨鲸交易摘要。在兼容的客户端中，可以扩展该提示词，让 LLM 提供总持仓价值或值得注意的交易符号等详细指标。

适用场景

适用于需要监控 Hyperliquid 平台上大额持仓和交易活动的用户，例如交易者、分析师或研究人员，通过集成到 MCP 客户端中，快速获取巨鲸动态。

限制

• 需要 CoinGlass API 密钥才能访问数据。
• 依赖 Python 3.10+ 和 uv。
• 项目采用 MIT 许可证，详情见 LICENSE 文件。