Cover image
Try Now
2025-03-14

用于跟踪加密货币鲸鱼交易的MCP服务器。

3 years

Works with Finder

1

Github Watches

3

Github Forks

9

Github Stars

Whale Tracker MCP Server

A Model Context Protocol (MCP) server for tracking cryptocurrency whale transactions using the Whale Alert API

MIT licensed Python Version

Table of Contents

Overview

The whale-tracker-mcp server is a Python-based implementation of the Model Context Protocol (MCP) that integrates with the Whale Alert API. It enables real-time tracking and analysis of large cryptocurrency transactions ("whale" movements) by exposing tools, resources, and prompts to MCP-compatible clients like Claude Desktop.

This server is designed for cryptocurrency enthusiasts, developers, and analysts who want to monitor whale activity directly within their LLM-powered workflows.

Features

  • Tools:
    • get_recent_transactions: Fetch recent whale transactions with optional filters for blockchain, minimum value, and limit.
    • get_transaction_details: Retrieve detailed information about a specific transaction by its ID.
  • Resources:
    • whale://transactions/{blockchain}: Expose recent transactions for a specified blockchain as contextual data.
  • Prompts:
    • query_whale_activity: A reusable template for analyzing whale transaction patterns, optionally filtered by blockchain.
  • Asynchronous API Calls: Uses httpx for efficient, non-blocking requests to the Whale Alert API.
  • Environment Variable Support: Securely manage your API key via a .env file.

Prerequisites

  • Python: Version 3.10 or higher.
  • Whale Alert API Key: Sign up at whale-alert.io to obtain an API key.
  • MCP Client: Compatible with MCP clients like Claude Desktop or the MCP Inspector.

Installation

  1. Clone the repository:
git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
  1. Install dependencies: We recommend using uv for dependency management:
uv add "mcp[cli]" httpx python-dotenv

Alternatively, use pip:

pip install mcp httpx python-dotenv
  1. Set up your API key: Create a .env file in the project root and add your Whale Alert API key:
WHALE_ALERT_API_KEY=your_api_key_here

Usage

Running in Development Mode

Test the server locally with the MCP Inspector:

mcp dev whale_tracker.py --with-editable .

This opens a web interface where you can explore the server's tools, resources, and prompts.

Integrating with Claude Desktop

Install the server into Claude Desktop for seamless integration:

mcp install whale_tracker.py --name "WhaleTracker" -f .env
  • --name "WhaleTracker": Sets a custom name for the server in Claude Desktop.
  • -f .env: Loads the API key from the .env file.

Restart Claude Desktop after installation. Look for the hammer icon in the input box to confirm the server is loaded, then try commands like:

  • "Show me recent whale transactions on Bitcoin."
  • "Get details for transaction ID 123456789."
  • "Analyze whale activity on Ethereum."

Direct Execution

Run the server standalone for custom deployments:

python whale_tracker.py

Or use the MCP CLI:

mcp run whale_tracker.py

Examples

Here’s how you might interact with the server in Claude Desktop:

Fetch Recent Transactions:

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

The server calls get_recent_transactions with blockchain="ethereum" and min_value=1000000.

Get Transaction Details:

Tell me about transaction ID 123456789.

The server uses get_transaction_details to fetch and display the transaction data.

Analyze Whale Activity:

Analyze recent whale transactions on Bitcoin.

The query_whale_activity prompt triggers an analysis based on the whale://transactions/bitcoin resource.

API Key Configuration

The server requires a Whale Alert API key, which is loaded from the WHALE_ALERT_API_KEY environment variable. To configure it:

  • Create a .env file:
WHALE_ALERT_API_KEY=your_api_key_here
  • Ensure python-dotenv is installed (included in the dependencies).
  • The server will automatically load the key at startup.

Alternatively, pass the key directly when running the server:

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

Happy whale tracking! 🐳

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Alexandru Strujac
  • Efficient thumbnail creator for YouTube videos

  • Callycode Limited
  • A geek-themed horoscope generator blending Bitcoin prices, tech jargon, and astrological whimsy.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Khalid kalib
  • Write professional emails

  • Beniyam Berhanu
  • Therapist adept at identifying core issues and offering practical advice with images.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • OffchainLabs
  • 进行以太坊的实施

  • huahuayu
  • 统一的API网关,用于将多个Etherscan样区块链Explorer API与对AI助手的模型上下文协议(MCP)支持。

  • deemkeen
  • 用电源组合控制您的MBOT2:MQTT+MCP+LLM

    Reviews

    1 (1)
    Avatar
    user_AmqMMbkE
    2025-04-16

    The whale-tracker-mcp by kukapay is an outstanding tool for tracking crypto whales. Its user-friendly interface and powerful features make it indispensable for anyone serious about cryptocurrency investments. The seamless integration and real-time updates keep you ahead of market trends. Highly recommend checking it out at https://github.com/kukapay/whale-tracker-mcp.