Whale Tracker MCP Server

基本能力

产品定位

Whale Tracker MCP Server 是一个用于跟踪和分析加密货币鲸鱼交易的 MCP 服务器，主要服务于加密货币领域的开发者和分析师。

核心功能

• 工具:
• get_recent_transactions: 获取最近的鲸鱼交易，支持按区块链、最小值和数量进行筛选。
• get_transaction_details: 通过交易 ID 获取特定交易的详细信息。
• 资源:
• whale://transactions/{blockchain}: 提供指定区块链的最近交易数据。
• 提示:
• query_whale_activity: 一个可重用的模板，用于分析鲸鱼交易模式，支持按区块链筛选。
• 异步 API 调用: 使用 httpx 进行高效的、非阻塞的请求。
• 环境变量支持: 通过 .env 文件安全管理 API 密钥。

适用场景

• 实时监控加密货币鲸鱼交易。
• 分析特定区块链上的鲸鱼活动。
• 在 LLM 工作流中集成鲸鱼交易数据。

工具列表

• get_recent_transactions: 获取最近的鲸鱼交易，支持筛选条件。
• get_transaction_details: 获取特定交易的详细信息。

常见问题解答

• 如何获取 API 密钥？ 需要到 whale-alert.io 注册并获取 API 密钥。
• 如何配置 API 密钥？ 在项目根目录下创建 .env 文件，并添加 WHALE_ALERT_API_KEY=your_api_key_here。

使用教程

使用依赖

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

安装教程

1. 克隆仓库:

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

1. 安装依赖: 推荐使用 uv 进行依赖管理:

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

或者使用 pip:

pip install mcp httpx python-dotenv

1. 配置 API 密钥: 在项目根目录创建 .env 文件并添加:

WHALE_ALERT_API_KEY=your_api_key_here

调试方式

1. 开发模式:

mcp dev whale_tracker.py --with-editable .

1. 集成到 Claude Desktop:

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

1. 直接运行:

python whale_tracker.py

或使用 MCP CLI:

mcp run whale_tracker.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。