Whale Tracker MCP 服务器

一个用于通过 Whale Alert API 跟踪加密货币鲸鱼交易的模型上下文协议（MCP）服务器

概述

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 客户端：与 Claude Desktop 或 MCP Inspector 等 MCP 客户端兼容。

安装

通过 Smithery 安装

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

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

克隆仓库：

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

安装依赖项：建议使用 uv 进行依赖管理：

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

或者使用 pip：

pip install mcp httpx python-dotenv

设置 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。
模型上下文协议团队提供 MCP 规范和 Python SDK。
httpx 提供强大的 HTTP 客户端库。

祝您鲸鱼追踪愉快！ 🐳