Crypto Liquidations MCP

加密货币清算 MCP

一个 MCP 服务，可从 Binance 实时传输加密货币清算事件，让 AI Agent 能够即时响应高波动性的市场变动。

功能

• 实时清算事件流：连接到 Binance WebSocket，捕获清算事件。
• 清算数据存储：在内存中维护最多 1000 条清算事件，不进行持久化存储。
• 工具：get_latest_liquidations：
  • 以 Markdown 表格的形式获取最新清算事件。
  • 列：Symbol、Side、Price、Quantity、Time（HH:MM:SS 格式）。
  • 参数：limit（默认值为 10）。
• 提示词：analyze_liquidations：
  • 生成提示词，调用 get_latest_liquidations 工具分析所有交易对的清算趋势。

前置条件

• Python 3.10：兼容性所需。
• uv：软件包和依赖项管理器（安装说明见下文）。
• 互联网连接：用于连接 Binance WebSocket。

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Crypto Liquidations：

npx -y @smithery/cli install @kukapay/crypto-liquidations-mcp --client claude

1. 克隆代码仓库

git clone https://github.com/kukapay/crypto-liquidations-mcp.git
cd crypto-liquidations-mcp

2. 安装依赖项

使用 uv 安装所需软件包：

uv sync

3. 集成 MCP 客户端

配置 MCP 客户端以连接到服务。对于 Claude Desktop：

{
 "mcpServers": {
   "crypto-liquidations": {
     "command": "uv",
     "args": ["--directory", "/path/to/crypto-liquidations-mcp", "run", "main.py"]
   }
 }
}

用法

开始使用时，启动 MCP 服务，即可开始从 Binance 传输清算事件。服务会在后台运行，在内存中收集最近的最多 1000 条事件，不生成日志，也不将数据保存到磁盘。

获取清算事件

使用 get_latest_liquidations 工具获取最新的清算事件。你可以使用 limit 参数指定要获取的事件数量（最多 1000 条）。例如，你可以询问：

“显示 Binance 最近发生的 5 起清算事件。”

这将返回格式清晰的表格，显示每起清算事件的交易对、买入或卖出方向、价格、数量和时间，时间格式为 HH:MM:SS。

输出示例：

| Symbol   | Side | Price  | Quantity | Time     |
|----------|------|--------|----------|----------|
| BTCUSDT  | BUY  | 50000  | 1.5      | 14:30:45 |
| ETHUSDT  | SELL | 3000   | 10.0     | 14:30:40 |
| BNBUSDT  | BUY  | 500    | 20.0     | 14:30:35 |
| ADAUSDT  | SELL | 1.2    | 1000.0   | 14:30:30 |
| XRPUSDT  | BUY  | 0.8    | 5000.0   | 14:30:25 |

此表格便于查看近期市场活动，例如 Binance 上的大额买入或卖出清算。

分析清算趋势

analyze_liquidations 提示词可帮助你深入分析数据。它会生成指令，用于分析所有交易对的清算趋势，重点关注频率、交易量和市场影响。提示词建议使用 get_latest_liquidations 工具获取数据，确保分析所用的信息是最新的。

这对于了解更广泛的市场动态特别有用，例如清算是否正在增加，或是否预示着显著的价格变动。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。