SuperAPI AI 工具集

whale-tracker-mcp

whale-tracker-mcp 是一个基于 Python 实现的 Model Context Protocol(MCP)服务器,用于追踪加密货币巨鲸(whale)大额交易。它集成 Whale Alert API,可向 Claude Desktop 等兼容 MCP 的客户端暴露工具、资源与提示模板,支持在 LLM 工作流中实时追踪和分析大额加密货币转账。主要工具包括:get_recent_transactions(按区块链、最小金额、数量限制筛选获取近期巨鲸交易)和 get_transaction_details(按交易 ID 查询交易详情);资源 whale://transactions/{blockchain} 提供指定区块链的上下文数据;提示模板 query_whale_activity 可用于分析巨鲸交易模式。使用前需注册 Whale Alert 获取 API Key,并通过 .env 文件或环境变量 WHALE_ALERT_API_KEY 配置。支持 Smithery 安装、MCP Inspector 本地测试,以及通过 mcp install 集成到 Claude Desktop。项目采用 MIT 许可证。

访问官网

工具介绍

用途

whale-tracker-mcp 是一个用 Python 实现的 Model Context Protocol(MCP)服务器,集成 Whale Alert API,用于实时追踪和分析加密货币巨鲸(大额)交易。它面向加密货币爱好者、开发者和分析师,帮助在 LLM 驱动的工作流(如 Claude Desktop)中直接监控巨鲸动态。

主要能力

该服务器向兼容 MCP 的客户端暴露以下能力:

  • 工具(Tools):
    • get_recent_transactions:获取近期巨鲸交易,支持按区块链、最小金额和数量上限等可选条件筛选。
    • get_transaction_details:根据交易 ID 查询某笔交易的详细信息。
  • 资源(Resources):
    • whale://transactions/{blockchain}:将指定区块链的近期交易作为上下文数据暴露。
  • 提示(Prompts):
    • query_whale_activity:可复用的模板,用于分析巨鲸交易模式,可按区块链筛选。
  • 其他特性:使用 httpx 进行异步、非阻塞的 API 调用;通过 .env 文件安全配置 API Key。

使用方式

环境要求

  • Python 版本 3.10 或更高。
  • Whale Alert API Key:在 whale-alert.io 注册获取。
  • MCP 客户端:兼容 Claude Desktop 或 MCP Inspector 等客户端。

安装与运行

  1. 克隆仓库:
    git clone <仓库地址>
    
  2. 安装依赖(推荐使用 uv,也可使用 pip): (具体命令暂未提供)
  3. 配置 API Key:在项目根目录创建 .env 文件,添加 Whale Alert API Key:
    WHALE_ALERT_API_KEY=<你的 key>
    
  4. 通过 Smithery 自动安装到 Claude Desktop: (具体命令暂未提供)
  5. 使用 MCP Inspector 在本地测试服务器: (具体命令暂未提供)打开 Web 界面后可浏览服务器的工具、资源与提示。
  6. 集成到 Claude Desktop:
    mcp install <命令>
    
    其中 --name "WhaleTracker" 可设置服务器自定义名称,-f .env 从 .env 文件加载 API Key。安装后重启 Claude Desktop,输入框出现锤子图标即表示加载成功。
  7. 独立运行(自定义部署): (具体命令暂未提供)或使用 MCP CLI。

交互示例

在 Claude Desktop 中可尝试如下命令:

  • “Show me recent whale transactions on Bitcoin.”(服务器会以 blockchain="bitcoin" 调用 get_recent_transactions)
  • “Get details for transaction ID 123456789.”(服务器使用 get_transaction_details 获取并展示交易数据)
  • “Analyze whale activity on Ethereum.”(query_whale_activity 提示会基于 whale://transactions/ethereum 资源触发分析)

API Key 也可在运行服务器时直接传入(具体方式暂未提供)。

适用场景

  • 在 Claude Desktop 等 MCP 客户端中实时追踪比特币、以太坊等区块链的巨鲸转账。
  • 按最小金额筛选大额交易,快速定位值得关注的市场动向。
  • 查询特定交易 ID 的详细信息。
  • 结合提示模板对某条区块链的巨鲸活动进行分析。

限制

  • 需要 Whale Alert API Key 才能使用,API 的可用性与配额取决于 Whale Alert 服务。
  • 依赖 Python 3.10+ 和 MCP 兼容客户端。
  • 具体依赖安装命令、Smithery 安装命令、MCP Inspector 测试命令及独立运行命令在资料中未完整提供。
  • 项目采用 MIT 许可证,详见 LICENSE 文件。

致谢

感谢 Whale Alert 提供追踪加密货币巨鲸交易的 API;感谢 Model Context Protocol 团队提供 MCP 规范与 Python SDK;感谢 httpx 提供稳健的 HTTP 客户端库。