Crypto Liquidations MCP

Crypto Liquidations MCP

Binance からリアルタイムの暗号資産清算イベントをストリーミングし、AI エージェントがボラティリティの高い市場の動きに即座に対応できるようにする MCP サーバーです。

機能

• リアルタイムの清算イベントのストリーミング：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 の下でライセンスされています。詳細については LICENSE ファイルを参照してください。