Hyperliquid Whalealert MCP

🚀 Hyperliquid WhaleAlert MCP

Hyperliquid WhaleAlert MCPは、Hyperliquid上で名目価値が100万ドルを超えるポジションをリアルタイムで検知し、通知するMCPサーバーです。

✨ 主な機能

• ツール: 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 Desktopへの統合： 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ツールは、大口取引データを取得し、Markdownリストとして返します。以下は出力例です：

- **ETH取引**:
  - ユーザーアドレス: 0x3fd4444154242720c0d0c61c74a240d90c127d33
  - ポジションサイズ: 12700
  - エントリー価格: $1611.62
  - 清算価格: $527.2521
  - ポジション価値 (USD): $21003260
  - アクション: クローズ
  - 作成時間: 2025-05-20 12:31:57
- **BTC取引**:
  - ユーザーアドレス: 0x1cadadf0e884ac5527ae596a4fc1017a4ffd4e2c
  - ポジションサイズ: 33.54032
  - エントリー価格: $87486.2
  - 清算価格: $44836.8126
  - ポジション価値 (USD): $2936421.4757
  - アクション: クローズ
  - 作成時間: 2025-05-20 12:31:17

ツールを呼び出すには：

• MCPインスペクターでget_whale_alertsを選択して実行します。
• Claude Desktopでは、登録されたサーバーを使用し、UIまたはAPIを介してツールを呼び出します。

プロンプトの使用方法

summarize_whale_activityプロンプトは、大口取引の概要を生成します。互換性のあるクライアントでの例を以下に示します：

/summarize_whale_activity

応答：

大口取引データを分析し、概要を提供します。

これは、LLMによって拡張され、総ポジション価値や注目すべきシンボルなどの詳細な指標を提供することができます。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。