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

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

Оглавление

• Обзор

• Функции

• Предпосылки

• Установка

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

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

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

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

• Примеры

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

• Лицензия

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

Related MCP server: agentek-eth

Обзор

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

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

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

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

pip install mcp httpx python-dotenv

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

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