Hyperliquid MCP Server

Hyperliquid MCP サーバー

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

概要

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

特徴

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

技術的特徴

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

前提条件

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

インストール

構成

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

環境変数

• 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ファイルを作成することもできます。

使用法

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

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

利用可能なツール

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

市場データツール

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

アカウント情報ツール

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

注文管理ツール

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

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

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

免責事項

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

ライセンス

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