whale-tracker-mcp

Integrations

  • Uses .env files for secure API key management, allowing users to store their Whale Alert API credentials safely outside of the codebase.

  • Allows tracking and analysis of whale transactions on the Bitcoin blockchain, including fetching recent large transactions and retrieving detailed transaction information.

  • Enables monitoring of whale activity on the Ethereum network, providing access to real-time data about large transactions with optional filtering by transaction value.

Whale Tracker MCP-Server

Ein Model Context Protocol (MCP)-Server zum Verfolgen von Kryptowährungs-Whale-Transaktionen mithilfe der Whale Alert API

Inhaltsverzeichnis

Überblick

Der whale-tracker-mcp Server ist eine Python-basierte Implementierung des Model Context Protocol (MCP) , die in die Whale Alert API integriert ist. Er ermöglicht die Echtzeitverfolgung und -analyse großer Kryptowährungstransaktionen („Whale“-Bewegungen), indem er Tools, Ressourcen und Eingabeaufforderungen für MCP-kompatible Clients wie Claude Desktop bereitstellt.

Dieser Server ist für Kryptowährungs-Enthusiasten, Entwickler und Analysten konzipiert, die die Walaktivität direkt in ihren LLM-gestützten Workflows überwachen möchten.

Merkmale

  • Werkzeuge :
    • get_recent_transactions : Ruft aktuelle Whale-Transaktionen mit optionalen Filtern für Blockchain, Mindestwert und Limit ab.
    • get_transaction_details : Rufen Sie anhand der ID detaillierte Informationen zu einer bestimmten Transaktion ab.
  • Ressourcen :
    • whale://transactions/{blockchain} : Aktuelle Transaktionen für eine angegebene Blockchain als Kontextdaten anzeigen.
  • Eingabeaufforderungen :
    • query_whale_activity : Eine wiederverwendbare Vorlage zum Analysieren von Wal-Transaktionsmustern, optional gefiltert nach Blockchain.
  • Asynchrone API-Aufrufe : Verwendet httpx für effiziente, nicht blockierende Anfragen an die Whale Alert API.
  • Unterstützung für Umgebungsvariablen : Verwalten Sie Ihren API-Schlüssel sicher über eine .env Datei.

Voraussetzungen

  • Python : Version 3.10 oder höher.
  • Whale Alert API-Schlüssel : Melden Sie sich bei whale-alert.io an, um einen API-Schlüssel zu erhalten.
  • MCP-Client : Kompatibel mit MCP-Clients wie Claude Desktop oder MCP Inspector.

Installation

Installation über Smithery

So installieren Sie Whale Tracker für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude
  1. Klonen Sie das Repository :
git clone https://github.com/kukapay/whale-tracker-mcp.git cd whale-tracker-mcp
  1. Abhängigkeiten installieren: Wir empfehlen die Verwendung von uv für die Abhängigkeitsverwaltung:
uv add "mcp[cli]" httpx python-dotenv

Alternativ können Sie pip verwenden:

pip install mcp httpx python-dotenv
  1. Richten Sie Ihren API-Schlüssel ein: Erstellen Sie eine .env-Datei im Projektstamm und fügen Sie Ihren Whale Alert-API-Schlüssel hinzu:
WHALE_ALERT_API_KEY=your_api_key_here

Verwendung

Ausführen im Entwicklungsmodus

Testen Sie den Server lokal mit dem MCP Inspector:

mcp dev whale_tracker.py --with-editable .

Dadurch wird eine Weboberfläche geöffnet, in der Sie die Tools, Ressourcen und Eingabeaufforderungen des Servers erkunden können.

Integration mit Claude Desktop

Installieren Sie den Server in Claude Desktop für eine nahtlose Integration:

mcp install whale_tracker.py --name "WhaleTracker" -f .env
  • --name "WhaleTracker" : Legt einen benutzerdefinierten Namen für den Server in Claude Desktop fest.
  • -f .env : Lädt den API-Schlüssel aus der .env-Datei.

Starten Sie Claude Desktop nach der Installation neu. Achten Sie auf das Hammersymbol im Eingabefeld, um zu bestätigen, dass der Server geladen ist. Versuchen Sie dann folgende Befehle:

  • „Zeigen Sie mir die letzten Wal-Transaktionen auf Bitcoin.“
  • "Details zur Transaktions-ID 123456789 abrufen."
  • „Analysieren Sie die Walaktivität auf Ethereum.“

Direkte Ausführung

Führen Sie den Server für benutzerdefinierte Bereitstellungen eigenständig aus:

python whale_tracker.py

Oder verwenden Sie die MCP-CLI:

mcp run whale_tracker.py

Beispiele

So können Sie mit dem Server in Claude Desktop interagieren:

Letzte Transaktionen abrufen:

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

Der Server ruft get_recent_transactions mit blockchain="ethereum" und min_value=1000000 auf.

Transaktionsdetails abrufen:

Tell me about transaction ID 123456789.

Der Server verwendet get_transaction_details , um die Transaktionsdaten abzurufen und anzuzeigen.

Walaktivität analysieren:

Analyze recent whale transactions on Bitcoin.

Die Eingabeaufforderung query_whale_activity löst eine Analyse basierend auf der Ressource whale://transactions/bitcoin aus.

API-Schlüsselkonfiguration

Der Server benötigt einen Whale Alert API-Schlüssel, der aus der Umgebungsvariable WHALE_ALERT_API_KEY geladen wird. So konfigurieren Sie ihn:

  • Erstellen Sie eine .env-Datei:
WHALE_ALERT_API_KEY=your_api_key_here
  • Stellen Sie sicher, dass python-dotenv installiert ist (in den Abhängigkeiten enthalten).
  • Der Server lädt den Schlüssel beim Start automatisch.

Alternativ können Sie den Schlüssel direkt beim Ausführen des Servers übergeben:

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

Danksagung

  • Whale Alert für die Bereitstellung der API zum Verfolgen von Kryptowährungs-Whale-Transaktionen.
  • Model Context Protocol-Team für die MCP-Spezifikation und das Python SDK.
  • httpx für eine robuste HTTP-Clientbibliothek.

Viel Spaß beim Wal-Tracking! 🐳

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein MCP-Server zum Verfolgen von Kryptowährungs-Whale-Transaktionen.

  1. Inhaltsverzeichnis
    1. Überblick
      1. Merkmale
        1. Voraussetzungen
          1. Installation
            1. Installation über Smithery
          2. Verwendung
            1. Ausführen im Entwicklungsmodus
            2. Integration mit Claude Desktop
            3. Direkte Ausführung
          3. Beispiele
            1. Letzte Transaktionen abrufen:
            2. Transaktionsdetails abrufen:
            3. Walaktivität analysieren:
          4. API-Schlüsselkonfiguration
            1. Lizenz
              1. Danksagung

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
                  Last updated -
                  3
                  136
                  25
                  TypeScript
                  MIT License
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Updated to use Coin Cap API v3
                  Last updated -
                  3
                  37
                  TypeScript
                  MIT License
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  A MCP server offering tools for cryptocurrency research and Ethereum-based automation.
                  Last updated -
                  113
                  45
                  35
                  TypeScript
                  AGPL 3.0
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server providing a range of cryptocurrency technical analysis indicators and strategies.
                  Last updated -
                  64
                  JavaScript
                  MIT License

                View all related MCP servers

                ID: 92khwbbyv1