whale-tracker-mcp

ホエールトラッカーMCPサーバー

Whale Alert APIを使用して暗号通貨のクジラ取引を追跡するためのモデルコンテキストプロトコル（MCP）サーバー

目次

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

概要

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

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

特徴

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

前提条件

• Python : バージョン 3.10 以上。
• Whale Alert API キー: API キーを取得するには、 whale-alert.ioにサインアップしてください。
• MCP クライアント: Claude Desktop や MCP Inspector などの MCP クライアントと互換性があります。

インストール

1. リポジトリをクローンします:

2. 依存関係をインストールします。依存関係の管理には uv を使用することをお勧めします。

あるいは、pip を使用します。

3. API キーを設定します。プロジェクト ルートに .env ファイルを作成し、Whale Alert API キーを追加します。

使用法

開発モードで実行

MCP Inspector を使用してサーバーをローカルでテストします。

これにより、サーバーのツール、リソース、およびプロンプトを調べることができる Web インターフェイスが開きます。

Claude Desktopとの統合

シームレスな統合のために、サーバーをClaude Desktopにインストールします。

• --name "WhaleTracker" : Claude Desktop 内のサーバーのカスタム名を設定します。
• -f .env : .env ファイルから API キーを読み込みます。

インストール後、Claude Desktopを再起動してください。入力ボックスのハンマーアイコンでサーバーがロードされていることを確認し、以下のコマンドを試してください。

• 「ビットコインにおける最近のクジラの取引を見せてください。」
• 「取引 ID 123456789 の詳細を取得します。」
• 「イーサリアム上のクジラの活動を分析します。」

直接実行

カスタム展開の場合はサーバーをスタンドアロンで実行します。

または、MCP CLI を使用します。

例

Claude Desktop でサーバーと対話する方法は次のとおりです。

最近の取引を取得:

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

取引の詳細を取得:

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

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

query_whale_activityプロンプトはwhale://transactions/bitcoinリソースに基づいて分析をトリガーします。

APIキーの設定

サーバーにはWhale Alert APIキーが必要です。これはWHALE_ALERT_API_KEY環境変数から読み込まれます。設定するには、以下の手順に従ってください。

• .env ファイルを作成します。

• python-dotenvがインストールされていることを確認します (依存関係に含まれています)。
• サーバーは起動時にキーを自動的にロードします。

あるいは、サーバーを実行するときにキーを直接渡します。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

謝辞

• 暗号通貨のクジラ取引を追跡するための API を提供するWhale Alert 。
• MCP 仕様と Python SDK のモデル コンテキスト プロトコルチーム。
• 堅牢な HTTP クライアント ライブラリのhttpx 。

クジラの追跡を楽しみましょう！🐳