whale-tracker-mcp

Integrations

  • Uses .env files for secure API key management, allowing users to store their Whale Alert API credentials safely outside of the codebase.

  • Allows tracking and analysis of whale transactions on the Bitcoin blockchain, including fetching recent large transactions and retrieving detailed transaction information.

  • Enables monitoring of whale activity on the Ethereum network, providing access to real-time data about large transactions with optional filtering by transaction value.

Сервер MCP для отслеживания китов

Сервер протокола контекста модели (MCP) для отслеживания транзакций криптовалютных китов с использованием API Whale Alert

Оглавление

Обзор

Сервер whale-tracker-mcp — это реализация протокола Model Context Protocol (MCP) на Python, которая интегрируется с API Whale Alert . Он позволяет отслеживать и анализировать крупные криптовалютные транзакции (перемещения «китов») в режиме реального времени, предоставляя инструменты, ресурсы и подсказки клиентам, совместимым с MCP, таким как Claude Desktop.

Этот сервер предназначен для энтузиастов криптовалюты, разработчиков и аналитиков, которые хотят отслеживать активность китов непосредственно в своих рабочих процессах на базе LLM.

Функции

  • Инструменты :
    • get_recent_transactions : получение последних транзакций китов с дополнительными фильтрами по блокчейну, минимальному значению и лимиту.
    • get_transaction_details : получение подробной информации о конкретной транзакции по ее идентификатору.
  • Ресурсы :
    • whale://transactions/{blockchain} : отображает последние транзакции для указанного блокчейна в виде контекстных данных.
  • Подсказки :
    • query_whale_activity : многоразовый шаблон для анализа моделей транзакций китов, опционально фильтруемый по блокчейну.
  • Асинхронные вызовы API : использует httpx для эффективных неблокирующих запросов к API Whale Alert.
  • Поддержка переменных среды : безопасное управление ключом API с помощью файла .env .

Предпосылки

  • Python : версия 3.10 или выше.
  • Ключ API Whale Alert : зарегистрируйтесь на whale-alert.io , чтобы получить ключ API.
  • Клиент MCP : совместим с клиентами MCP, такими как Claude Desktop или MCP Inspector.

Установка

Установка через Smithery

Чтобы автоматически установить Whale Tracker для Claude Desktop через Smithery :

npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude
  1. Клонируйте репозиторий :
git clone https://github.com/kukapay/whale-tracker-mcp.git cd whale-tracker-mcp
  1. Установка зависимостей: Мы рекомендуем использовать uv для управления зависимостями:
uv add "mcp[cli]" httpx python-dotenv

В качестве альтернативы можно использовать pip:

pip install mcp httpx python-dotenv
  1. Настройте свой ключ API: создайте файл .env в корне проекта и добавьте свой ключ API Whale Alert:
WHALE_ALERT_API_KEY=your_api_key_here

Использование

Работа в режиме разработки

Протестируйте сервер локально с помощью MCP Inspector:

mcp dev whale_tracker.py --with-editable .

Откроется веб-интерфейс, в котором вы сможете изучить инструменты, ресурсы и подсказки сервера.

Интеграция с Claude Desktop

Установите сервер в Claude Desktop для бесшовной интеграции:

mcp install whale_tracker.py --name "WhaleTracker" -f .env
  • --name "WhaleTracker" : Устанавливает пользовательское имя для сервера в Claude Desktop.
  • -f .env : Загружает ключ API из файла .env.

Перезапустите Claude Desktop после установки. Найдите значок молотка в поле ввода, чтобы подтвердить загрузку сервера, затем попробуйте команды типа:

  • «Покажите мне последние транзакции китов на Bitcoin».
  • «Получить данные по идентификатору транзакции 123456789».
  • «Проанализируйте активность китов на Ethereum».

Прямое исполнение

Запустите сервер автономно для пользовательских развертываний:

python whale_tracker.py

Или используйте MCP CLI:

mcp run whale_tracker.py

Примеры

Вот как вы можете взаимодействовать с сервером в Claude Desktop:

Извлечь последние транзакции:

What are the latest whale transactions on Ethereum with a minimum value of $1,000,000?

Сервер вызывает get_recent_transactions с blockchain="ethereum" и min_value=1000000 .

Получить детали транзакции:

Tell me about transaction ID 123456789.

Сервер использует get_transaction_details для извлечения и отображения данных транзакции.

Анализ активности китов:

Analyze recent whale transactions on Bitcoin.

Запрос query_whale_activity запускает анализ на основе ресурса whale://transactions/bitcoin .

Конфигурация ключа API

Серверу требуется ключ API Whale Alert, который загружается из переменной среды WHALE_ALERT_API_KEY . Чтобы настроить его:

  • Создайте файл .env:
WHALE_ALERT_API_KEY=your_api_key_here
  • Убедитесь, что установлен python-dotenv (включен в зависимости).
  • Сервер автоматически загрузит ключ при запуске.

Либо передайте ключ непосредственно при запуске сервера:

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE.

Благодарности

  • Whale Alert за предоставление API для отслеживания транзакций криптовалютных китов.
  • Команда Model Context Protocol для спецификации MCP и Python SDK.
  • httpx для надежной клиентской библиотеки HTTP.

Удачного отслеживания китов! 🐳

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер mcp для отслеживания транзакций криптовалютных китов.

  1. Оглавление
    1. Обзор
      1. Функции
        1. Предпосылки
          1. Установка
            1. Установка через Smithery
          2. Использование
            1. Работа в режиме разработки
            2. Интеграция с Claude Desktop
            3. Прямое исполнение
          3. Примеры
            1. Извлечь последние транзакции:
            2. Получить детали транзакции:
            3. Анализ активности китов:
          4. Конфигурация ключа API
            1. Лицензия
              1. Благодарности

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
                  Last updated -
                  3
                  136
                  25
                  TypeScript
                  MIT License
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Updated to use Coin Cap API v3
                  Last updated -
                  3
                  37
                  TypeScript
                  MIT License
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  A MCP server offering tools for cryptocurrency research and Ethereum-based automation.
                  Last updated -
                  113
                  45
                  35
                  TypeScript
                  AGPL 3.0
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server providing a range of cryptocurrency technical analysis indicators and strategies.
                  Last updated -
                  64
                  JavaScript
                  MIT License

                View all related MCP servers

                ID: 92khwbbyv1