Hyperliquid MCP 服务器

本项目使用 Node.js 实现了一个模型上下文协议 (MCP) 服务器，允许您查询您的 Hyperliquid 开放仓位。该服务器公开了一个工具，可以从 MCP 客户端（如 Claude Desktop 应用程序）访问。

概述

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

这将生成 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 提出如下问题：

   "你能告诉我 0x7f3B192Ab3220940D66236792F3EBDB0e4E74138 在 hyperliquid 上的仓位的未实现盈亏吗？"
   

4. Claude 将识别合适的工具并要求您确认
5. 单击“允许”以执行查询
6. Claude 将显示您的查询结果

使用示例

1. 询问 Claude 关于您的仓位
2. Claude 识别所需的工具
3. 批准工具的使用
4. 直接在聊天中获取您的仓位信息

这种无缝集成使您可以通过与 Claude 的自然对话快速访问您的 Hyperliquid 交易信息。