whale-tracker-mcp

鲸鱼追踪器 MCP 服务器

使用 Whale Alert API 跟踪加密货币鲸鱼交易的模型上下文协议 (MCP) 服务器

目录

• 概述
• 特征
• 先决条件
• 安装
• 用法
  • 以开发模式运行
  • 与 Claude Desktop 集成
  • 直接执行
• 示例
• API 密钥配置
• 执照
• 致谢

概述

whale-tracker-mcp服务器是基于 Python 的模型上下文协议 (MCP)实现，并与Whale Alert API集成。它通过向 Claude Desktop 等兼容 MCP 的客户端公开工具、资源和提示，实现了对大型加密货币交易（“鲸鱼”动向）的实时跟踪和分析。

该服务器专为希望在 LLM 驱动的工作流程中直接监控鲸鱼活动的加密货币爱好者、开发人员和分析师而设计。

特征

• 工具：
  • get_recent_transactions ：使用区块链、最小值和限制的可选过滤器获取最近的鲸鱼交易。
  • get_transaction_details ：通过 ID 检索特定交易的详细信息。
• 资源：
  • whale://transactions/{blockchain} ：将指定区块链的近期交易作为上下文数据公开。
• 提示：
  • query_whale_activity ：用于分析鲸鱼交易模式的可重复使用模板，可选择通过区块链进行过滤。
• 异步 API 调用：使用httpx向 Whale Alert API 发出高效、非阻塞请求。
• 环境变量支持：通过.env文件安全地管理您的 API 密钥。

先决条件

• Python ：版本 3.10 或更高版本。
• Whale Alert API 密钥：在whale-alert.io注册以获取 API 密钥。
• 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文件。

致谢

• Whale Alert提供 API 来追踪加密货币鲸鱼交易。
• MCP 规范和 Python SDK 的模型上下文协议团队。
• httpx是一个强大的 HTTP 客户端库。

祝您追踪鲸鱼愉快！🐳