# kukapay
## 基本信息
- Slug: `kukapay-crypto-liquidations-mcp`
- Source: modelscope
- Publisher: @kukapay/crypto-liquidations-mcp
- Categories: cryptocurrency / 金融 / web3
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@kukapay/crypto-liquidations-mcp
## 简介
暂无描述。
## MCP Server 详情

# Crypto Liquidations MCP
[![smithery badge](https://smithery.ai/badge/@kukapay/crypto-liquidations-mcp)](https://smithery.ai/server/@kukapay/crypto-liquidations-mcp)

这是一个MCP服务器，它从Binance流式传输实时加密货币清算事件，使AI代理能够即时对高波动性市场变动做出反应。

![License](https://img.shields.io/badge/license-MIT-green)
![Python Version](https://img.shields.io/badge/python-3.10-blue)
![Status](https://img.shields.io/badge/status-active-brightgreen.svg)


## 特性

- **实时清算流**：连接到[Binance WebSocket](wss://fstream.binance.com/ws/!forceOrder@arr`) 以捕获清算事件。
- **清算数据存储**：在内存中维护最多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](https://smithery.ai/server/@kukapay/crypto-liquidations-mcp)自动为Claude Desktop安装Crypto Liquidations：

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


### 1. 克隆仓库
bash
git clone https://github.com/kukapay/crypto-liquidations-mcp.git
cd crypto-liquidations-mcp


### 2. 安装依赖
使用`uv`安装所需的包：
bash
uv sync


### 3. 与MCP客户端集成
配置您的MCP客户端以连接到服务器。对于Claude Desktop：
json
{
 "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](LICENSE)文件。