JinDaGe - whale-tracker-mcp MCP Details

article

README

🚀 鲸鱼追踪 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，可借助 Whale Alert API 实时追踪加密货币鲸鱼交易，为加密货币领域的相关人员提供有力支持。

🚀 快速开始

whale-tracker-mcp 服务器是基于 Python 的 Model Context Protocol (MCP) 实现，与 Whale Alert API 集成。它能实时跟踪和分析大型加密货币交易（“鲸鱼”动向），并为 MCP 兼容客户端（如 Claude Desktop）提供工具、资源和提示，适合加密货币爱好者、开发人员和分析师在 LLM 驱动工作流程中直接监控鲸鱼活动。

✨ 主要特性

工具：
- get_transaction_details：获取交易详细信息。
- analyze_whale_activity：分析鲸鱼活动。
资源：
- whale://transactions/{currency}：提供特定货币的鲸鱼交易数据。
提示：
- query_whale_activity：触发对鲸鱼交易的分析。

📦 安装指南

先决条件

要运行此服务器，您需要以下内容：

Python 3.8 或更高版本。
安装 MCP Python SDK：
```
pip install mcp-sdk
```
** Whale Alert API 密钥**：请访问 Whale Alert 获取您的密钥。

安装步骤

克隆仓库：

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

安装依赖项：
```
pip install -r requirements.txt
```

💻 使用示例

开发模式运行

python src/server.py --mode development

与 Claude Desktop 集成

安装服务器：
```
mcp install whale-tracker-mcp
```

启动服务器并指定环境变量：

mcp install whale-tracker-mcp -v WHALE_ALERT_API_KEY=your_api_key_here

直接执行

mcp run whale_tracker_mcp -- --mode production

示例代码

基础用法

# 获取特定交易的详细信息
curl http://localhost:8000/api/transactions/<transaction_id>

高级用法

# 分析鲸鱼活动，访问特定货币的鲸鱼交易数据并触发分析
# 这里以比特币为例
curl http://localhost:8000/api/transactions/bitcoin && mcp run whale_tracker_mcp -- --mode production query_whale_activity

📚 详细文档

API 密钥配置

服务器需要 Whale Alert API 密钥，通过 WHALE_ALERT_API_KEY 环境变量加载。配置方法如下：

创建 .env 文件：
```
WHALE_ALERT_API_KEY=your_api_key_here
```
确保安装了 python-dotenv（包含在依赖项中）。
启动服务器时，密钥将自动加载。

📄 许可证

本项目按 MIT 许可证发布。有关详细信息，请参阅 LICENSE 文件。

👏 致谢

Whale Alert 提供跟踪加密货币鲸鱼交易的 API。
Model Context Protocol 团队为 MCP 规范和 Python SDK。
httpx 用于 robust HTTP 客户端库。

愉快的鲸鱼追踪！ 🐳

whale-tracker-mcp