Whale Tracker MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于使用 Whale Alert API 跟踪加密货币巨鲸交易

<!-- omit in toc -->

目录

• 概述
• 特性
• 先决条件
• 安装
• 使用
  • 在开发模式下运行
  • 与 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）兼容。

安装

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。在输入框中查找锤子图标以确认服务器已加载，然后尝试以下命令：

• "Show me recent whale transactions on Bitcoin." (显示比特币上最近的巨鲸交易。)
• "Get details for transaction ID 123456789." (获取交易 ID 123456789 的详细信息。)
• "Analyze whale activity on Ethereum." (分析以太坊上的巨鲸活动。)

直接执行

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

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?

(以太坊上价值至少 1,000,000 美元的最新巨鲸交易是什么？) 服务器调用 get_recent_transactions，其中 blockchain="ethereum" 和 min_value=1000000。

获取交易详情：

Tell me about transaction ID 123456789.

(告诉我关于交易 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 客户端库。

祝您鲸鱼追踪愉快！ 🐳