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

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

git clone https://github.com/kukapay/whale-tracker-mcp.git cd whale-tracker-mcp

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

uv add "mcp[cli]" httpx python-dotenv

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

pip install mcp httpx python-dotenv

Настройте свой ключ 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.

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