Whale Tracker MCP

🚀 鲸鱼追踪 MCP サーバー

Model Context Protocol (MCP) をベースとしたサーバーで、Whale Alert API を通じて暗号通貨のウェール取引をリアルタイムで追跡します。

目次

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

🚀 クイックスタート

whale-tracker-mcp サーバーは、Python ベースの Model Context Protocol (MCP) の実装で、Whale Alert API と統合されています。これにより、大規模な暗号通貨取引（「ウェール」の動向）をリアルタイムで追跡および分析し、MCP 互換クライアント（Claude Desktop など）にツール、リソース、およびプロンプトを提供します。このサーバーは、自らの LLM 駆動ワークフローで直接ウェール活動を監視したい暗号通貨愛好家、開発者、およびアナリストに最適です。

✨ 主な機能

ツール

• get_transaction_details：取引の詳細情報を取得します。
• analyze_whale_activity：ウェールの活動を分析します。

リソース

• whale://transactions/{currency}：特定の通貨のウェール取引データを提供します。

プロンプト

• query_whale_activity：ウェール取引の分析をトリガーします。

📦 インストール

前提条件

このサーバーを実行するには、以下が必要です。

1. Python 3.8 以上
2. MCP Python SDK のインストール

   pip install mcp-sdk
   

3. Whale Alert API キー：Whale Alert を訪問してキーを取得してください。

インストール手順

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

   git clone https://github.com/kukapay/whale-tracker-mcp.git
   cd whale-tracker-mcp
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

開発モードで実行

python src/server.py --mode development

Claude Desktop との統合

1. サーバーをインストールします。

   mcp install whale-tracker-mcp
   

2. サーバーを起動し、環境変数を指定します。

   mcp install whale-tracker-mcp -v WHALE_ALERT_API_KEY=your_api_key_here
   

直接実行

mcp run whale_tracker_mcp -- --mode production

取引詳細の取得

特定の取引の詳細情報を取得するには、以下のコマンドを実行します。

curl http://localhost:8000/api/transactions/<transaction_id>

ウェール活動の分析

ウェール活動を分析するには、リソース whale://transactions/bitcoin にアクセスし、プロンプト query_whale_activity を使用します。

📚 ドキュメント

API キーの設定

サーバーは Whale Alert API キーが必要で、WHALE_ALERT_API_KEY 環境変数を通じて読み込まれます。設定方法は以下の通りです。

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

   WHALE_ALERT_API_KEY=your_api_key_here
   

2. python-dotenv がインストールされていることを確認してください（依存関係に含まれています）。
3. サーバーを起動すると、キーが自動的に読み込まれます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

謝辞

• Whale Alert：暗号通貨のウェール取引を追跡する API を提供しています。
• Model Context Protocol チーム：MCP 仕様と Python SDK を提供しています。
• httpx：堅牢な HTTP クライアントライブラリです。

楽しいウェール追跡を！ 🐳