Servidor MCP de Whale Tracker

Un servidor de Protocolo de Contexto Modelo (MCP) para rastrear transacciones de ballenas de criptomonedas utilizando la API Whale Alert

Tabla de contenido

• Descripción general

• Características

• Prerrequisitos

• Instalación

• Uso

  • Ejecutando en modo de desarrollo

  • Integración con Claude Desktop

  • Ejecución directa

• Ejemplos

• Configuración de la clave API

• Licencia

• Expresiones de gratitud

Related MCP server: agentek-eth

Descripción general

El servidor whale-tracker-mcp es una implementación basada en Python del Protocolo de Contexto de Modelo (MCP) que se integra con la API Whale Alert . Permite el seguimiento y análisis en tiempo real de grandes transacciones de criptomonedas (movimientos de ballenas) mediante la exposición de herramientas, recursos y avisos a clientes compatibles con MCP, como Claude Desktop.

Este servidor está diseñado para entusiastas de las criptomonedas, desarrolladores y analistas que desean monitorear la actividad de las ballenas directamente dentro de sus flujos de trabajo impulsados por LLM.

Características

• Herramientas :

  • get_recent_transactions : obtiene transacciones recientes de ballenas con filtros opcionales para blockchain, valor mínimo y límite.

  • get_transaction_details : recupera información detallada sobre una transacción específica por su ID.

• Recursos :

  • whale://transactions/{blockchain} : expone transacciones recientes de una cadena de bloques específica como datos contextuales.

• Indicaciones :

  • query_whale_activity : una plantilla reutilizable para analizar patrones de transacciones de ballenas, opcionalmente filtrada por blockchain.

• Llamadas API asincrónicas : utiliza httpx para realizar solicitudes eficientes y sin bloqueos a la API Whale Alert.

• Compatibilidad con variables de entorno : administre de forma segura su clave API a través de un archivo .env .

Prerrequisitos

• Python : versión 3.10 o superior.

• Clave API de Whale Alert : regístrese en whale-alert.io para obtener una clave API.

• Cliente MCP : compatible con clientes MCP como Claude Desktop o MCP Inspector.

Instalación

1. Clonar el repositorio :

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

2. Instalar dependencias: Recomendamos utilizar uv para la gestión de dependencias:

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

Alternativamente, utilice pip:

pip install mcp httpx python-dotenv

3. Configura tu clave API: crea un archivo .env en la raíz del proyecto y agrega tu clave API de Whale Alert:

WHALE_ALERT_API_KEY=your_api_key_here

Uso

Ejecutando en modo de desarrollo

Pruebe el servidor localmente con el Inspector MCP:

mcp dev whale_tracker.py --with-editable .

Esto abre una interfaz web donde puedes explorar las herramientas, los recursos y las indicaciones del servidor.

Integración con Claude Desktop

Instale el servidor en Claude Desktop para una integración perfecta:

mcp install whale_tracker.py --name "WhaleTracker" -f .env

• --name "WhaleTracker" : establece un nombre personalizado para el servidor en Claude Desktop.

• -f .env : carga la clave API desde el archivo .env.

Reinicie Claude Desktop después de la instalación. Busque el icono del martillo en el cuadro de entrada para confirmar que el servidor está cargado y luego pruebe comandos como:

• "Muéstrame transacciones recientes de ballenas en Bitcoin".

• "Obtener detalles de la transacción ID 123456789."

• "Analizar la actividad de las ballenas en Ethereum".

Ejecución directa

Ejecute el servidor de forma independiente para implementaciones personalizadas:

python whale_tracker.py

O utilice la CLI de MCP:

mcp run whale_tracker.py

Ejemplos

Así es como puedes interactuar con el servidor en Claude Desktop:

Obtener transacciones recientes:

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

El servidor llama get_recent_transactions con blockchain="ethereum" y min_value=1000000 .

Obtener detalles de la transacción:

Tell me about transaction ID 123456789.

El servidor utiliza get_transaction_details para obtener y mostrar los datos de la transacción.

Analizar la actividad de las ballenas:

Analyze recent whale transactions on Bitcoin.

La solicitud query_whale_activity activa un análisis basado en el recurso whale://transactions/bitcoin .

Configuración de la clave API

El servidor requiere una clave API de Whale Alert, que se carga desde la variable de entorno WHALE_ALERT_API_KEY . Para configurarla:

• Crea un archivo .env:

WHALE_ALERT_API_KEY=your_api_key_here

• Asegúrese de que python-dotenv esté instalado (incluido en las dependencias).

• El servidor cargará automáticamente la clave al iniciarse.

Alternativamente, pase la clave directamente al ejecutar el servidor:

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Expresiones de gratitud

• Whale Alert proporciona la API para rastrear las transacciones de ballenas de criptomonedas.

• Equipo de Protocolo de Contexto de Modelo para la especificación MCP y el SDK de Python.

• httpx para una biblioteca de cliente HTTP robusta.

¡Feliz avistamiento de ballenas! 🐳