Hyperliquid MCP

🚀 Hyperliquid MCP 服務器

本項目基於 Node.js 實現了一個模型上下文協議 (MCP) 服務器，藉助該服務器，您能夠查詢在 Hyperliquid 上的持倉頭寸。此服務器還提供了一個工具，可通過 MCP 客戶端（例如 Claude Desktop 應用程序）進行訪問。

🚀 快速開始

MCP 服務器提供了名為 get-hyperliquid-positions 的工具，Claude 可利用該工具獲取任意 Hyperliquid 錢包地址的未實現 PnL 和頭寸信息，實現了 Claude 與您的 Hyperliquid 交易數據的無縫交互。

✨ 主要特性

• 提供 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

這將生成 dist/index.js 文件，該文件將被 MCP 服務器使用。

配置 Claude Desktop

1. 打開 Claude Desktop 應用程序。
2. 轉到菜單欄的 Claude → 設置 → 開發者 → 編輯配置。
3. 這將在 Finder 中打開您的配置文件（在 macOS 上）。
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 如下問題：

"你能告訴我我在 hyperliquid 上針對 0x7f3B192Ab3220940D66236792F3EBDB0e4E74138 的未實現 pnl 嗎"

4. Claude 將識別所需的工具並請求您的確認。
5. 點擊 "允許" 以執行查詢。
6. Claude 將在聊天中顯示查詢結果。

高級用法

1. 詢問 Claude 關於您的頭寸信息。
2. Claude 會識別所需的工具。
3. 允許工具使用。
4. 直接在聊天中獲取您的頭寸信息。

這種無縫集成使您能夠快速通過與 Claude 的自然對話訪問您的 Hyperliquid 交易信息。