Whale Tracker MCP

🚀 鯨魚追蹤 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，可藉助 Whale Alert 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>

高級用法

# 分析鯨魚活動，訪問特定貨幣的鯨魚交易數據並觸發分析
# 這裡以比特幣為例
curl http://localhost:8000/api/transactions/bitcoin && mcp run whale_tracker_mcp -- --mode production 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 用於 robust HTTP 客戶端庫。

愉快的鯨魚追蹤！ 🐳