hyperliquid-mcp

hyperliquid-mcp

AI エージェントに Hyperliquid を見渡す力を。 小規模な読み取り専用のMCPサーバーです。Claude（または MCP 互換のエージェント）から、Hyperliquid の無期限先物市場、資金調達率、オーダーブック、ローソク足に加え、あらゆるアドレスのポジション、約定、資金調達を照会できます。

• 🔑 API キーもウォレットも署名も不要 — 公開 Info API のみを使用します。取引は一切できません。
• 📦 設定不要 — MCP 設定にエントリーを 1 つ追加すれば完了です。
• 🪶 軽量 — ソースファイル 2 つ、依存関係 2 つ（MCP SDK + zod）。

クイックスタート

Claude Code

claude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcp

Claude Desktop / Cursor / 任意の MCP クライアント

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "@kitsune-de/hyperliquid-mcp"]
    }
  }
}

ソースから

git clone https://github.com/kitsune-de/hyperliquid-mcp
cd hyperliquid-mcp && npm install && npm run build
# then point your MCP client at: node /path/to/hyperliquid-mcp/dist/index.js

質問できること

「今の Hyperliquid で、資金調達率が最も極端なものは何ですか？」

「0xabc… の未決済ポジションと清算価格を表示して、清算までどれくらい近いか教えてください。」

「過去 1 週間に、私のアカウントが支払った資金調達料をコインごとに教えてください。」

「HYPE の 4 時間足ローソクを取得して、トレンドを説明してください。」

ツール

ツール	引数	戻り値
get_markets	coin?、sortBy?（volume · funding · change · openInterest）、limit?	無期限先物市場：マーク価格、24 時間の変動率と取引高、建玉、資金調達率（1 時間あたり + 年率 APR）、最大レバレッジ
get_price	coins?	指定したコイン、またはすべての無期限先物のミッド価格
get_orderbook	coin、depth?	L2 スナップショット：最良買い気配／売り気配、スプレッド率、各サイドの価格レベル
get_candles	coin、interval?、count?	OHLCV ローソク足（1m … 1w）
get_account	address	アカウント価値、証拠金使用量、出金可能額、すべての無期限先物ポジション（サイド、サイズ、エントリー価格、清算価格、uPnL、レバレッジ）、現物残高
get_open_orders	address	未約定注文：サイド、価格、サイズ、種類、トリガー情報
get_recent_fills	address、limit?	最近の約定：方向、価格、サイズ、想定元本、決済済み PnL、手数料
get_funding_paid	address、hours?	指定期間にコインごとに支払った／受け取った純資金調達料

すべてのアカウントツールは、自分のアドレス、クジラのアドレス、ボールトのアドレスなど、あらゆるアドレスで利用できます。すべて公開オンチェーンデータです。

設定

環境変数	デフォルト	用途
HL_INFO_URL	https://api.hyperliquid.xyz/info	テストネットでは https://api.hyperliquid-testnet.xyz/info に設定します

開発

npm install
npm run build
npm run smoke   # spawns the server over stdio and exercises every tool against live mainnet

免責事項

読み取り専用の市場データツールです。金融上の助言ではなく、Hyperliquid とは提携していません。

ライセンス

MIT