Whale Tracker MCP Server

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

<!-- 目录中省略 -->

目录

• 概述
• 特性
• 前提条件
• 安装
• 使用
  • 在开发模式下运行
  • 与Claude Desktop集成
  • 直接执行
• 示例
• API密钥配置
• 许可证
• 致谢

概述

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

此服务器专为加密货币爱好者、开发者和分析师设计，他们希望在其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客户端：兼容MCP客户端，如Claude Desktop或MCP Inspector。

安装

通过Smithery安装

要通过Smithery自动安装Whale Tracker for Claude Desktop：

npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude

1. 克隆仓库：

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

2. 安装依赖项：我们建议使用uv进行依赖管理：

uv add "mcp[cli]" httpx python-dotenv

或者使用pip：

pip install mcp httpx python-dotenv

3. 设置您的API密钥：在项目根目录创建一个.env文件，并添加您的Whale Alert API密钥：

WHALE_ALERT_API_KEY=your_api_key_here

使用

在开发模式下运行

本地测试服务器与MCP Inspector：

mcp dev whale_tracker.py --with-editable .

这会打开一个Web界面，您可以在其中探索服务器的工具、资源和提示。

与Claude Desktop集成

将服务器安装到Claude Desktop以实现无缝集成：

mcp install whale_tracker.py --name "WhaleTracker" -f .env

• --name "WhaleTracker"：在Claude Desktop中设置服务器的自定义名称。
• -f .env：从.env文件加载API密钥。

安装后重启Claude Desktop。查看输入框中的锤子图标确认服务器已加载，然后尝试以下命令：

• “显示比特币上的最新巨鲸交易。”
• “获取交易ID 123456789的详情。”
• “分析以太坊上的巨鲸活动。”

直接执行

独立运行服务器以进行自定义部署：

python whale_tracker.py

或者使用MCP CLI：

mcp run whale_tracker.py

示例

这里是如何在Claude Desktop中与服务器交互的一些示例：

获取最近的交易：

以太坊上价值至少1,000,000美元的最新巨鲸交易是什么？

服务器调用get_recent_transactions，参数为blockchain="ethereum"和min_value=1000000。

获取交易详情：

告诉我关于交易ID 123456789的信息。

服务器使用get_transaction_details来获取并显示交易数据。

分析巨鲸活动：

分析比特币上的最近巨鲸交易。

query_whale_activity提示触发基于whale://transactions/bitcoin资源的分析。

API密钥配置

服务器需要一个Whale Alert API密钥，该密钥从WHALE_ALERT_API_KEY环境变量加载。要配置它：

• 创建一个.env文件：

WHALE_ALERT_API_KEY=your_api_key_here

• 确保安装了python-dotenv（包含在依赖项中）。
• 服务器将在启动时自动加载该密钥。

或者，在运行服务器时直接传递密钥：

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

许可证

本项目根据MIT许可证发布。详见LICENSE文件。

致谢

• Whale Alert提供了跟踪加密货币巨鲸交易的API。
• Model Context Protocol团队提供了MCP规范和Python SDK。
• httpx提供了强大的HTTP客户端库。

愉快地追踪巨鲸！ 🐳