Whale Tracker MCP Server

Whale Tracker MCP Server

Whale Alert API を使用して暗号資産のクジラ取引を追跡する Model Context Protocol（MCP）サーバー

目次

• 概要
• 機能
• 前提条件
• インストール
• 使用方法
  • 開発モードでの実行
  • Claude Desktop との連携
  • 直接実行
• 例
• API キーの設定
• ライセンス
• 謝辞

概要

whale-tracker-mcp サーバーは、Whale Alert API と連携する Model Context Protocol（MCP） の Python ベースの実装です。Claude Desktop など、MCP 対応クライアントにツール、リソース、プロンプトを公開することで、大規模な暗号資産取引（「クジラ」の動き）をリアルタイムで追跡・分析できます。

このサーバーは、LLM を活用したワークフロー内でクジラの動向を直接監視したい暗号資産の愛好家、開発者、アナリスト向けに設計されています。

機能

• ツール：
  • get_recent_transactions：ブロックチェーン、最小金額、件数のフィルターを任意で指定して、最近のクジラ取引を取得します。
  • get_transaction_details：ID を指定して、特定の取引の詳細情報を取得します。
• リソース：
  • whale://transactions/{blockchain}：指定したブロックチェーンの最近の取引を、コンテキストデータとして公開します。
• プロンプト：
  • query_whale_activity：ブロックチェーンで任意に絞り込んで、クジラ取引のパターンを分析する再利用可能なテンプレートです。
• 非同期 API 呼び出し：httpx を使用し、Whale Alert API への効率的なノンブロッキングリクエストを実行します。
• 環境変数のサポート：.env ファイルを使用して API キーを安全に管理します。

前提条件

• Python：バージョン 3.10 以降。
• Whale Alert API キー：whale-alert.io で登録して API キーを取得してください。
• MCP クライアント：Claude Desktop や MCP Inspector などの MCP クライアントに対応しています。

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の Whale Tracker を自動インストールするには：

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 ファイルを作成し、Whale Alert API キーを追加します：

WHALE_ALERT_API_KEY=your_api_key_here

使用方法

開発モードでの実行

MCP Inspector を使って、サーバーをローカルでテストします：

mcp dev whale_tracker.py --with-editable .

Web インターフェースが開き、サーバーのツール、リソース、プロンプトを確認できます。

Claude Desktop との連携

シームレスに連携できるよう、サーバーを Claude Desktop にインストールします：

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

• --name "WhaleTracker"：Claude Desktop でサーバーに任意の名前を設定します。
• -f .env：.env ファイルから API キーを読み込みます。

インストール後、Claude Desktop を再起動します。入力欄にハンマーのアイコンが表示され、サーバーが読み込まれていることを確認してから、次のようなコマンドを試してください：

• 「Bitcoin の最近のクジラ取引を表示して。」
• 「取引 ID 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?

サーバーは blockchain="ethereum" および min_value=1000000 を指定して get_recent_transactions を呼び出します。

トランザクションの詳細を取得する：

Tell me about transaction ID 123456789.

サーバーはget_transaction_detailsを使用して、トランザクションデータを取得して表示します。

クジラの活動を分析する：

Analyze recent whale transactions on Bitcoin.

query_whale_activityプロンプトは、whale://transactions/bitcoinリソースに基づく分析を開始します。

API キーの設定

サーバーにはWhale Alert API キーが必要です。このキーは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ファイルをご覧ください。

謝辞

• 暗号資産のクジラによるトランザクションを追跡するAPIを提供してくださったWhale Alertに感謝します。
• MCP仕様とPython SDKを提供してくださったModel Context Protocolチームに感謝します。
• 堅牢なHTTPクライアントライブラリを提供するhttpxに感謝します。

クジラの追跡をお楽しみください！ 🐳