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 交易信息。