whale-tracker-mcp

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

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

Оглавление

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

Обзор

Сервер 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 :

1. Клонируйте репозиторий :

2. Установка зависимостей: Мы рекомендуем использовать uv для управления зависимостями:

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

3. Настройте свой ключ API: создайте файл .env в корне проекта и добавьте свой ключ API Whale Alert:

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

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

• Создайте файл .env:

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

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

Лицензия

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

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

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

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