Hyperliquid Mcp

io.github.kitsune-de由 GitHub 帳號 kitsune-de 發布v0.1.0更新於 Oct 24, 2026

Read-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

一個唯讀的 MCP 伺服器，讓助理查詢 Hyperliquid 永續合約市場、資金費率、訂單簿、K 線，以及任意地址的持倉與成交紀錄。

可以做什麼
查詢永續市場，取得標記價格、24 小時漲跌、成交量、未平倉量、資金費率與最高槓桿，並取得指定幣種或全部永續合約的中間價。讀取 L2 訂單簿快照，包含最佳買賣價與價差，並拉取 1 分鐘到 1 週的 OHLCV K 線。查看任意地址的帳戶價值、保證金占用、含強平價格的持倉以及現貨餘額。查看掛單與近期成交，包括方向、名目金額、已平倉損益和手續費。依幣種彙總指定時間窗口內的淨資金費支出或收入。
適用情境
適合讓助理分析 Hyperliquid 永續市場，或查看自己及他人公開地址的鏈上交易情況，且不需要任何交易能力。適用於資金費率比較、訂單簿與 K 線研判，以及持倉和強平風險相關問題。
執行需求
以 stdio 方式在本機執行，通常透過 npm 套件用 npx 啟動，需要 Node.js 以及連線至 Hyperliquid Info API 的網路。無需 API 金鑰或錢包。可選環境變數 HL_INFO_URL 可改為指向測試網端點。
安裝前請注意
設計上為唯讀，無法交易或簽名，但它會查詢任意地址的公開鏈上資料，因此你詢問的帳戶資訊會傳送給上游 API。市場資料僅供參考，不構成投資建議，行動前請自行核實數據。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hyperliquid Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

hyperliquid-mcp

Give your AI agent eyes on Hyperliquid. A tiny, read-only MCP server that lets Claude (or any MCP-compatible agent) query Hyperliquid perp markets, funding rates, order books, candles — and the positions, fills and funding of any address.

  • 🔑 No API keys, no wallets, no signing — only the public Info API. It cannot trade, ever.
  • 📦 Zero config — one entry in your MCP config and you're done.
  • 🪶 Tiny — two source files, two dependencies (MCP SDK + zod).

Quick start

Claude Code

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

Claude Desktop / Cursor / any MCP client

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

From source

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

What you can ask

"What are the most extreme funding rates on Hyperliquid right now?"

"Show the open positions and liquidation prices of 0xabc… — how close is it to liquidation?"

"How much funding did my account pay over the last week, per coin?"

"Pull 4h candles for HYPE and describe the trend."

Tools

ToolArgumentsReturns
get_marketscoin?, sortBy? (volume · funding · change · openInterest), limit?Perp markets: mark price, 24h change & volume, open interest, funding (1h + annualized APR), max leverage
get_pricecoins?Mid prices for given coins, or all perp mids
get_orderbookcoin, depth?L2 snapshot: best bid/ask, spread %, levels per side
get_candlescoin, interval?, count?OHLCV candles (1m … 1w)
get_accountaddressAccount value, margin usage, withdrawable, every perp position (side, size, entry, liq price, uPnL, leverage), spot balances
get_open_ordersaddressResting orders: side, price, size, type, trigger info
get_recent_fillsaddress, limit?Recent fills: direction, price, size, notional, closed PnL, fees
get_funding_paidaddress, hours?Net funding paid/received per coin over a window

All account tools work on any address — your own, a whale's, a vault's. It's all public on-chain data.

Configuration

Env varDefaultPurpose
HL_INFO_URLhttps://api.hyperliquid.xyz/infoSet to https://api.hyperliquid-testnet.xyz/info for testnet

Development

bash
npm installnpm run buildnpm run smoke   # spawns the server over stdio and exercises every tool against live mainnet

Disclaimer

Read-only market data tooling. Not financial advice; no affiliation with Hyperliquid.

License

MIT

來源：README.md，提交 b2bf5c6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分