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 客户端库。

愉快的鲸鱼追踪！ 🐳