Hyperliquid Info MCP Server

Hyperliquid Info MCP サーバー

Hyperliquid の無期限先物 DEX からリアルタイムのデータとインサイトを提供する MCP サーバーで、ボット、ダッシュボード、分析での利用を目的としています。

機能

• ユーザーデータのクエリ:

  • get_user_state: 無期限先物またはスポット市場におけるユーザーのポジション、証拠金、出金可能残高を取得します。
  • get_user_open_orders: ユーザーアカウントのすべての未約定注文を取得します。
  • get_user_trade_history: シンボル、サイズ、価格などの詳細を含む約定履歴を取得します。
  • get_user_funding_history: カスタマイズ可能な期間指定で資金調達手数料の支払い履歴をクエリします。
  • get_user_fees: ユーザー固有の手数料体系（メイカー/テイカー料率）を取得します。
  • get_user_staking_summary と get_user_staking_rewards: ステーキングの詳細と報酬にアクセスします。
  • get_user_order_by_oid と get_user_order_by_cloid: 注文 ID またはクライアント注文 ID で特定の注文詳細を取得します。
  • get_user_sub_accounts: メインアカウントに関連付けられたサブアカウントを一覧表示します。

• 市場データツール:

  • get_all_mids: すべての取引ペアのミッドプライスを取得します。
  • get_l2_snapshot: 特定のコインのレベル 2 オーダーブックスナップショットを取得します。
  • get_candles_snapshot: カスタマイズ可能な間隔と期間指定でローソク足データを取得します。
  • get_coin_funding_history: 特定のコインの資金調達率履歴をクエリします。
  • get_perp_dexs: 無期限先物市場のメタデータを取得します（meta を使用）。
  • get_perp_metadata と get_spot_metadata: 無期限先物市場とスポット市場の詳細なメタデータを取得します（任意でアセットコンテキストを含みます）。

• 分析プロンプト:

  • analyze_positions: 関連するツールを使用してユーザーの取引活動を分析するためのガイド付きプロンプト。

• ISO 8601 サポート: 時間ベースのクエリ（get_candles_snapshot、get_coin_funding_history、get_user_funding_history）は、正確なデータフィルタリングのために ISO 8601 形式の時刻文字列を受け付けます。

インストール

前提条件

• Python 3.10: Hyperliquid Python SDK で必要です。
• ユーザー固有のクエリには、有効な Hyperliquid アカウントアドレスが必要です。
• パッケージ管理には uv または pip を使用します。

手順

1. リポジトリをクローン:

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

2. 依存関係をインストール: uv を使用する場合:

   uv sync
   

使用方法

サーバーの実行

MCP Inspector を使用して開発モードでサーバーを実行します:

mcp dev main.py

または、Claude Desktop で使用するためにインストールします:

mcp install main.py --name "Hyperliquid Info"

使用例

MCP Inspector または Claude Desktop を使用すると、自然言語のプロンプトでサーバーを操作できます。以下は、analyze_positions プロンプトと個々のツールを会話形式でトリガーする方法の例です。

1. トレードポジションを分析する:

   • プロンプト:
     「アドレス 0xYourAddress の Hyperliquid アカウントの取引活動を分析してください。ポジション、未約定注文、最近の取引に関するインサイトを提供してください。」
   • 動作:
     これにより analyze_positions プロンプトがトリガーされ、get_user_state、get_user_open_orders、get_user_trade_history、get_user_funding_history、get_user_fees を使用してデータを取得し、リスク・パフォーマンス分析を生成します。
   • 出力例:

     For account 0xYourAddress:
     - Current Positions: 0.1 BTC long at $50,000, unrealized PNL +$500.
     - Open Orders: 1 limit order to sell 0.05 BTC at $52,000.
     - Recent Trades: Bought 0.1 BTC at $50,000 on 2025-05-30.
     - Funding Payments: Paid $10 in funding fees last week.
     - Fees: Maker fee 0.02%, taker fee 0.05%.
     Recommendation: Monitor BTC price closely due to high leverage.
     

2. ユーザー状態を取得する:

   • プロンプト:
     「私の Hyperliquid アカウント 0xYourAddress の現在の状態を、パーペチュアルのポジションと証拠金の詳細を含めて表示してください。」
   • 動作:
     get_user_state(account_address="0xYourAddress", check_spot=False) を呼び出します。
   • 出力例:

     {
       "assetPositions": [
         {
           "position": {
             "coin": "BTC",
             "szi": "0.1",
             "entryPx": "50000.0",
             "markPx": "50500.0",
             "unrealizedPnl": "500.0"
           }
         }
       ],
       "marginSummary": {
         "accountValue": "10000.0",
         "totalMarginUsed": "2000.0"
       },
       "withdrawable": "8000.0"
     }
     

3. ローソク足データを取得する:

   • プロンプト:
     「Hyperliquid 上の ETH の 2025年1月1日から2025年1月2日までの1分足ローソク足データを取得できますか？」
   • 動作:
     get_candles_snapshot(coin_name="ETH", interval="1m", start_time="2025-01-01T00:00:00Z", end_time="2025-01-02T00:00:00Z") を呼び出します。
   • 出力例:

     [
       {
         "t": 1672531200000,
         "o": "3000.0",
         "h": "3010.0",
         "l": "2995.0",
         "c": "3005.0",
         "v": "1000.0"
       },
       ...
     ]
     

4. 取引履歴を確認する:

   • プロンプト:
     「Hyperliquid 上の私のアカウント 0xYourAddress の最近の取引は何ですか？」
   • 動作:
     get_user_trade_history(account_address="0xYourAddress") を呼び出します。
   • 出力例:

     [
       {
         "coin": "ETH",
         "px": "3000.0",
         "sz": "0.5",
         "time": 1672531200000,
         "tid": "123456"
       },
       ...
     ]
     

5. 市場メタデータを取得する:

   • プロンプト:
     「Hyperliquid で利用可能なパーペチュアル市場について、取引ペアを含めて教えてください。」
   • 動作:
     get_perp_metadata(include_asset_ctxs=False) を呼び出します。
   • 出力例:

     {
       "universe": [
         {
           "name": "BTC-PERP",
           "maxLeverage": 50,
           "szDecimals": 4,
           "tickSz": "0.1"
         },
         ...
       ]
     }
     

ライセンス

このプロジェクトは MIT License の下でライセンスされています。