AI导哈

加密货币鲸鱼交易追踪服务

一个基于Model Context Protocol (MCP)的服务，用于通过Whale Alert API实时追踪和分析大额加密货币交易（鲸鱼活动）。适用于加密货币爱好者、开发者和分析师。

  • by kukapay
  • Python
  • 本地部署
  • 58 星标
  • 更新于
在 GitHub 查看 kukapay/whale-tracker-mcp

使用说明

鲸鱼追踪器MCP服务器

模型上下文协议（MCP）服务器，用于使用鲸鱼警报API跟踪加密货币鲸鱼交易

目录

概述

这 whale-tracker-mcp server是一个基于Python的实现 模型上下文协议（MCP） 它与 API鲸鱼警报。它通过向兼容MCP的客户端（如Claude Desktop）公开工具、资源和提示，实现了对大型加密货币交易（“鲸鱼”运动）的实时跟踪和分析。

该服务器专为加密货币爱好者、开发人员和分析师设计，他们希望在LLM驱动的工作流程中直接监控鲸鱼活动。

特性

  • 工具:
    • get_recent_transactions：使用区块链、最小值和限制的可选过滤器获取最近的鲸鱼交易。
    • get_transaction_details：通过特定交易的ID检索其详细信息。
  • 资源:
    • whale://transactions/{blockchain}：将指定区块链的最近交易作为上下文数据公开。
  • 提示:
    • query_whale_activity：用于分析鲸鱼交易模式的可重用模板，可选择通过区块链过滤。
  • 异步API调用：用途 httpx 为鲸鱼警报API提供高效、非阻塞的请求。
  • 环境变量支持：通过 .env 文件。

先决条件

  • python：版本3.10或更高版本。
  • 鲸鱼警报API密钥：注册地址： whale-alert.io 以获得API密钥。
  • MCP客户端：与Claude Desktop或MCP Inspector等MCP客户端兼容。

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面的鲸鱼追踪器 史密瑟里:

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
  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检查器在本地测试服务器：

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

获取最近交易记录：

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文件。

致谢

  • 鲸鱼警报，用于提供API来跟踪加密货币鲸鱼交易。
  • MCP规范和Python SDK的模型上下文协议团队。
  • httpx是一个强大的HTTP客户端库。

追踪鲸鱼快乐！ 🐳

相关 MCP