鲸鱼追踪 MCP 服务器

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

![MIT licensed][mit-badge]
![Python Version][python-badge]

目录

• 概述
• 功能
• 前提条件
• 安装
• 使用方法
  • 在开发模式下运行
  • 与 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 客户端：与 Claude Desktop 或 MCP Inspector 等 MCP 客户端兼容。

安装

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 密钥：

WHALE_ALERT_API_KEY=your_api_key_here

使用方法

在开发模式下运行

使用 MCP Inspector 本地测试服务器：

mcp dev whale_tracker.py --with-editable .

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

与 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 中与服务器交互的方式：

获取最近的交易：

What are the latest whale transactions on Ethereum with a minimum value of $1,000,000?

服务器调用 get_recent_transactions 并设置参数 blockchain="ethereum" 和 min_value=1000000。

获取交易详情：

Tell me about transaction ID 123456789.

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

分析鲸鱼活动：

Analyze recent whale transactions on Bitcoin.

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客户端库。

愉快地追踪鲸鱼吧！ 🐳