mcpField
W
Whale Tracker MCP Server

Whale Tracker MCP Server

本地服务
github.com/kukapay金融数据5877 周前更新
代码仓库

关于 Whale Tracker MCP Server

Whale Tracker MCP Server 是基于 Python 实现的 MCP 服务，通过 Whale Alert API 追踪加密货币大额交易（鲸鱼转账）。它面向加密货币爱好者、开发者和分析人员，可在 LLM 工作流中直接查看鲸鱼活动。

主要功能

  1. 01查询近期鲸鱼交易并支持多种过滤条件
  2. 02按交易 ID 获取交易详情
  3. 03以资源形式提供各区块链的近期交易
  4. 04提供鲸鱼活动分析提示词模板
  5. 05使用 httpx 进行异步 API 调用

适用场景

  1. 01查看比特币或以太坊上的大额转账
  2. 02分析某条区块链的鲸鱼交易模式
  3. 03查询指定交易的详细信息

MCP 相关

该服务向 MCP 客户端暴露两个工具、一个资源和一个提示词，客户端如 Claude Desktop 可直接调用这些功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "whale-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Whale Tracker MCP 服务

一种基于 Whale Alert API 跟踪加密货币巨鲸交易的模型上下文协议（MCP）服务

mit license python versions smithery badge

目录

概述

whale-tracker-mcp 服务是基于 Python 实现的模型上下文协议（MCP），并与 Whale Alert API 集成。它通过向 Claude Desktop 等兼容 MCP 的客户端提供工具、资源和提示词，实现对大额加密货币交易（“巨鲸”交易）的实时跟踪和分析。

此服务面向加密货币爱好者、开发者和分析师，帮助他们在由大模型驱动的工作流中直接监控巨鲸活动。

功能

  • 工具：
    • 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 自动将 Whale Tracker 安装到 Claude Desktop：

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

  • “显示 Bitcoin 上近期的巨鲸交易。”
  • “获取交易 ID 123456789 的详细信息。”
  • “分析 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?

服务会调用 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 许可。详情请参阅 LICENSE 文件。

致谢

  • 感谢 Whale Alert 提供用于追踪加密货币巨鲸交易的 API。
  • 感谢 Model Context Protocol 团队提供 MCP 规范和 Python SDK。
  • 感谢 httpx 提供强大的 HTTP 客户端库。

祝你追踪巨鲸愉快！🐳

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。