用途
whale-tracker-mcp 是一个用 Python 实现的 Model Context Protocol(MCP)服务器,集成 Whale Alert API,用于实时追踪和分析加密货币巨鲸(大额)交易。它面向加密货币爱好者、开发者和分析师,帮助在 LLM 驱动的工作流(如 Claude Desktop)中直接监控巨鲸动态。
主要能力
该服务器向兼容 MCP 的客户端暴露以下能力:
- 工具(Tools):
- get_recent_transactions:获取近期巨鲸交易,支持按区块链、最小金额和数量上限等可选条件筛选。
- get_transaction_details:根据交易 ID 查询某笔交易的详细信息。
- 资源(Resources):
- whale://transactions/{blockchain}:将指定区块链的近期交易作为上下文数据暴露。
- 提示(Prompts):
- query_whale_activity:可复用的模板,用于分析巨鲸交易模式,可按区块链筛选。
- 其他特性:使用 httpx 进行异步、非阻塞的 API 调用;通过 .env 文件安全配置 API Key。
使用方式
环境要求
- Python 版本 3.10 或更高。
- Whale Alert API Key:在 whale-alert.io 注册获取。
- MCP 客户端:兼容 Claude Desktop 或 MCP Inspector 等客户端。
安装与运行
- 克隆仓库:
git clone <仓库地址> - 安装依赖(推荐使用 uv,也可使用 pip): (具体命令暂未提供)
- 配置 API Key:在项目根目录创建 .env 文件,添加 Whale Alert API Key:
WHALE_ALERT_API_KEY=<你的 key> - 通过 Smithery 自动安装到 Claude Desktop: (具体命令暂未提供)
- 使用 MCP Inspector 在本地测试服务器: (具体命令暂未提供)打开 Web 界面后可浏览服务器的工具、资源与提示。
- 集成到 Claude Desktop:
其中 --name "WhaleTracker" 可设置服务器自定义名称,-f .env 从 .env 文件加载 API Key。安装后重启 Claude Desktop,输入框出现锤子图标即表示加载成功。mcp install <命令> - 独立运行(自定义部署): (具体命令暂未提供)或使用 MCP CLI。
交互示例
在 Claude Desktop 中可尝试如下命令:
- “Show me recent whale transactions on Bitcoin.”(服务器会以 blockchain="bitcoin" 调用 get_recent_transactions)
- “Get details for transaction ID 123456789.”(服务器使用 get_transaction_details 获取并展示交易数据)
- “Analyze whale activity on Ethereum.”(query_whale_activity 提示会基于 whale://transactions/ethereum 资源触发分析)
API Key 也可在运行服务器时直接传入(具体方式暂未提供)。
适用场景
- 在 Claude Desktop 等 MCP 客户端中实时追踪比特币、以太坊等区块链的巨鲸转账。
- 按最小金额筛选大额交易,快速定位值得关注的市场动向。
- 查询特定交易 ID 的详细信息。
- 结合提示模板对某条区块链的巨鲸活动进行分析。
限制
- 需要 Whale Alert API Key 才能使用,API 的可用性与配额取决于 Whale Alert 服务。
- 依赖 Python 3.10+ 和 MCP 兼容客户端。
- 具体依赖安装命令、Smithery 安装命令、MCP Inspector 测试命令及独立运行命令在资料中未完整提供。
- 项目采用 MIT 许可证,详见 LICENSE 文件。
致谢
感谢 Whale Alert 提供追踪加密货币巨鲸交易的 API;感谢 Model Context Protocol 团队提供 MCP 规范与 Python SDK;感谢 httpx 提供稳健的 HTTP 客户端库。