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

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 :

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

Alternativamente, utilice pip:

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

Uso

Ejecutando en modo de desarrollo

Pruebe el servidor localmente con el Inspector MCP:

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:

• --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:

O utilice la CLI de MCP:

Ejemplos

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

Obtener transacciones recientes:

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

Obtener detalles de la transacción:

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

Analizar la actividad de las ballenas:

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:

• 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:

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! 🐳