Hyperliquid MCP

🚀 Hyperliquid MCP サーバー

このプロジェクトは、Node.js でモデルコンテキストプロトコル (MCP) サーバーを実装しており、Hyperliquid の保有ポジションを照会することができます。このサーバーは、MCP クライアント（Claude Desktop アプリケーションなど）からアクセスできるツールを提供します。

🚀 クイックスタート

MCP サーバーを使って、Claude と Hyperliquid の取引データを連携させ、保有ポジションの情報を取得しましょう。以下に手順を説明します。

✨ 主な機能

MCP サーバーは get-hyperliquid-positions というツールを提供しており、Claude が任意の Hyperliquid ウォレットアドレスの未実現損益 (PnL) とポジション情報を取得できるようになります。これにより、Claude と Hyperliquid の取引データ間でシームレスなやり取りが可能になります。

📦 インストール

前提条件

• システムに Node.js がインストールされていること
• Claude Desktop アプリケーションがインストールされていること
• npm（Node パッケージマネージャー）が利用可能であること

プロジェクトのビルド

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

これにより、MCP サーバーで使用される dist/index.js ファイルが生成されます。

Claude Desktop の設定

1. Claude Desktop アプリケーションを開きます。
2. メニューバーの Claude → 設定 → 開発者 → 設定の編集 を選択します。
3. これにより、macOS の場合は Finder で設定ファイルが開きます。
4. 以下の設定をファイルに追加します。

{
    "mcpServers": {
        "hyperliquid": {
            "command": "node",
            "args": [
                "/path/to/your/hyperliquid-mcp/dist/index.js"
            ]
        }
    }
}

/path/to/your を実際のプロジェクトディレクトリのパスに置き換えてください。 5. 設定ファイルを保存します。 6. Claude Desktop アプリケーションを再起動します。

💻 使用例

基本的な使用法

設定が完了したら、以下の手順でツールを使用できます。

1. チャット入力ボックスの右下にハンマーアイコンが表示されます。
2. MCP ツールが "get-hyperliquid-positions" として表示されます。
3. Claude に以下のような質問をすることができます。

"0x7f3B192Ab3220940D66236792F3EBDB0e4E74138 の hyperliquid 上の未実現 pnl を教えてくれますか"

4. Claude が必要なツールを認識し、確認を求めます。
5. "許可" をクリックしてクエリを実行します。
6. Claude がチャット内にクエリ結果を表示します。

このシームレスな統合により、Claude との自然な会話を通じて Hyperliquid の取引情報に迅速にアクセスできます。