Hyperliquid MCP サーバー

Hyperliquid SDK をラップし、AI アシスタントに暗号通貨取引機能を提供する包括的なモデルコンテキストプロトコル (MCP) サーバー。

概要

このMCPサーバーは、AIアシスタントがHyperliquid取引所と連携して市場データの取得、取引の執行、ポジション管理などを行うことを可能にします。モデルコンテキストプロトコル（MCP）を実装し、あらゆる取引機能を提供します。

特徴

スポット取引と先物取引の両方に対応するすべてのHyperliquid SDK APIの完全実装
市場データの取得（価格、注文書、ローソク足）
注文の配置と管理（マーケット、リミット、トリガー、TWAP）
ポジション管理（レバレッジ、マージン、クローズ）
アカウント情報と残高
資金調達率情報
送金と引き出し
金庫管理
サブアカウント管理
紹介システムの統合

技術的特徴

秘密鍵とウォレットアドレスの両方を使用した適切な認証
包括的なエラー処理と検証
リアルタイム市場データアクセス
注文追跡のためのクライアント注文ID（クラウド）のサポート
テストネットとメインネットの両方をサポート

前提条件

Node.js (v14以上)
Hyperliquidアカウント
認証用のEthereum秘密鍵（取引に必要）
ウォレットアドレス（取引に必要）

インストール

# Clone the repository
git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server.git

# Navigate to the project directory
cd hyperliquid-mcp-server

# Install dependencies
npm install

構成

サーバーは、環境変数または構成ファイルを使用して構成できます。

環境変数

HYPERLIQUID_PRIVATE_KEY : 認証用のEthereum秘密鍵（取引に必要）
HYPERLIQUID_WALLET_ADDRESS : ウォレットアドレス（取引に必須）
HYPERLIQUID_VAULT_ADDRESS : 保管庫のアドレス（オプション、保管庫操作用）
HYPERLIQUID_TESTNET : テストネットを使用する場合は「true」に設定し、メインネットを使用する場合は「false」に設定します（デフォルト: false）
LOG_LEVEL : ログレベル - 'debug'、'info'、'warn'、または 'error' (デフォルト: 'info')

設定ファイル

サーバーと同じディレクトリに、次の構造を持つ.hyperliquid-config.jsonファイルを作成することもできます。

{
  "privateKey": "your-ethereum-private-key",
  "walletAddress": "your-wallet-address",
  "vaultAddress": "your-vault-address",
  "testnet": false,
  "logLevel": "info",
  "popularCoins": ["BTC", "ETH", "SOL", "AVAX", "ARB", "DOGE", "LINK", "MATIC"]
}

使用法

次のコマンドを実行してサーバーを起動します。

npm start

または、デモクライアントを実行します。

npm run demo

利用可能なツール

サーバーは、Hyperliquid取引所とやり取りするための包括的なツールセットを提供します。以下にいくつか例を挙げます。

市場データツール

getMarketPrice : 指定された暗号通貨の現在の価格を取得します
getOrderBook : 指定された暗号通貨の現在の注文書を取得します。
getCandleData : 指定された暗号通貨の過去のキャンドルデータを取得します
getAllMids : 利用可能なすべての暗号通貨の中間価格を取得します

アカウント情報ツール

getAccountInfo : ユーザーの永久先物口座に関する情報を取得します
getSpotAccountInfo : ユーザーのスポット取引口座に関する情報を取得する
getUserOpenOrders : ユーザーのすべてのオープン注文を取得する
getUserFills : ユーザーの最近の入力内容を取得する

注文管理ツール

placeMarketOrder : 指定された暗号通貨の市場注文を出す
placeLimitOrder : 指定された暗号通貨の指値注文を出す
placeTriggerOrder : トリガー注文（損切りまたは利益確定）を出す
placeTwapOrder : TWAP（時間加重平均価格）注文を出す
cancelOrder : 既存の注文をキャンセルする
cancelOrderByCloid : クライアントの注文IDで注文をキャンセルする
cancelAllOrders : すべてのオープン注文をキャンセルする
modifyOrder : 既存の注文を変更する

セキュリティに関する考慮事項

秘密鍵のセキュリティ：Ethereumの秘密鍵は、あなたの資金への完全なアクセスを提供します。秘密鍵を決して共有したり、公開リポジトリに公開したりしないでください。
最初にテストネットを使用する: メインネットで実際の資金を使用する前に、必ずテストネットでセットアップをテストしてください。
アクセス制限: MCP サーバーへのアクセスを、信頼できる AI アシスタントとアプリケーションに制限します。

免責事項

暗号通貨の取引には大きなリスクが伴います。このツールは教育および情報提供のみを目的として提供されています。取引を行う前に必ずリスクを理解し、失っても構わない資金で取引しないでください。

ライセンス

マサチューセッツ工科大学

Hyperliquid MCP Server

Integrations