Для чего этот сервер?

Этот MCP-сервер помогает отслеживать крупные движения на Hyperliquid — позиции от миллиона долларов и выше. Он собирает данные о китовых сделках и отдаёт их в удобном виде: таблица с последними транзакциями или сводка активности за период. Трейдерам и аналитикам не нужно вручную мониторить рынок — сервер сам достаёт, где крупные игроки открывают или закрывают позиции.

Каталог MCP
kukapay/hyperliquid-whalealert-mcp

kukapay/hyperliquid-whalealert-mcp

от kukapay

MCP сервер для мониторинга крупных сделок (китов) на Hyperliquid. Флаг позиции с номиналом более $1 млн — полезный инструмент для трейдеров, желающих отслеживать движение крупного капитала. Получай...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Hyperliquid WhaleAlert MCP

An MCP server that provides real-time whale alerts on Hyperliquid, flagging positions with a notional value exceeding $1 million.

GitHub License

Features

Tool: get_whale_alerts: Fetches recent whale transactions and returns them as a Markdown table using pandas for clean formatting.
Prompt: summarize_whale_activity: Generates a summary of whale transactions, including metrics like total position value and notable symbols.

Prerequisites

Python: Version 3.10 or higher.
CoinGlass API Key: Obtain from CoinGlass (required for API access).
uv: Package and dependency manager (install uv).

Installation

Clone the Repository:

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

Install Dependencies:
```
uv sync
```
This installs dependencies specified in pyproject.toml.

Claude Desktop Integration: Install the server in Claude Desktop:

uv run mcp install mcp.py --name "Hyperliquid Whale Alert"

Or update the configuration file manually:

{
  "mcpServers": {
    "hyperliquid-whalealert": {
      "command": "uv",
      "args": [ "--directory", "/path/to/hyperliquid-whalealert-mcp", "run", "main.py" ],
      "env": { "COINGLASS_API_KEY": "your_api_key" }
    }
  }
}

Replace /path/to/hyperliquid-whalealert-mcp with your actual installation path and COINGLASS_API_KEY with your API key.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить kukapay/hyperliquid-whalealert-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"kukapay-hyperliquid-whalealert-mcp-6819tswkdb\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/path/to/hyperliquid-whalealert-mcp\",\"run\",\"main.py\"],\"env\":{\"COINGLASS_API_KEY\":\"your_api_key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add kukapay-hyperliquid-whalealert-mcp-6819tswkdb --env COINGLASS_API_KEY=your_api_key -- uv --directory /path/to/hyperliquid-whalealert-mcp run main.py

Либо через JSON-конфиг:

claude mcp add-json kukapay-hyperliquid-whalealert-mcp-6819tswkdb "{\"command\":\"uv\",\"args\":[\"--directory\",\"/path/to/hyperliquid-whalealert-mcp\",\"run\",\"main.py\"],\"env\":{\"COINGLASS_API_KEY\":\"your_api_key\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add kukapay-hyperliquid-whalealert-mcp-6819tswkdb --env COINGLASS_API_KEY=your_api_key -- uv --directory /path/to/hyperliquid-whalealert-mcp run main.py

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.kukapay-hyperliquid-whalealert-mcp-6819tswkdb]
command = "uv"
args = ["--directory", "/path/to/hyperliquid-whalealert-mcp", "run", "main.py"]

[mcp_servers.kukapay-hyperliquid-whalealert-mcp-6819tswkdb.env]
COINGLASS_API_KEY = "your_api_key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите kukapay/hyperliquid-whalealert-mcp, а в поле команды запуска — строку ниже:

uv --directory /path/to/hyperliquid-whalealert-mcp run main.py

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например kukapay-hyperliquid-whalealert-mcp-6819tswkdb.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: kukapay-hyperliquid-whalealert-mcp-6819tswkdb
    command: uv
    args:
      - "--directory"
      - "/path/to/hyperliquid-whalealert-mcp"
      - "run"
      - "main.py"
    env:
      COINGLASS_API_KEY: your_api_key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "kukapay-hyperliquid-whalealert-mcp-6819tswkdb": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hyperliquid-whalealert-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "COINGLASS_API_KEY": "your_api_key"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/hyperliquid-whalealert-mcp",
    "run",
    "main.py"
  ],
  "env": {
    "COINGLASS_API_KEY": "your_api_key"
  }
}