Crypto Orderbook MCP

Crypto Orderbook MCP

主要な暗号資産取引所におけるオーダーブックの厚みと不均衡を分析する MCP サーバーです。AI エージェントや取引システムに、リアルタイムの市場構造に関する洞察を提供します。

特長

• オーダーブック指標：指定した取引所の取引ペアについて、買い注文と売り注文の厚みおよび不均衡を計算します。
• 取引所間の比較：複数の取引所のオーダーブックの厚みと不均衡を、統一された Markdown テーブルで比較します。
• 対応取引所：Binance、Kraken、Coinbase、Bitfinex、Okx、Bybit

インストール

前提条件

• Python 3.10 以上
• uv（Python パッケージおよびプロジェクトの管理ツール）

セットアップ

1. リポジトリをクローンする

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

2. 依存関係をインストールする

   uv を使用して必要なパッケージをインストールします。

   uv sync
   

3. MCP クライアント（Claude Desktop）を設定する

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

使い方

サーバーは、主に次の 2 つのツールを提供します。

1. calculate_orderbook：指定した取引所の取引ペアについて、買い注文の厚み、売り注文の厚み、不均衡を計算します。
2. compare_orderbook：複数の取引所の買い注文の厚み、売り注文の厚み、不均衡を比較し、Markdown テーブルを返します。

例：オーダーブック指標を計算する

プロンプト：「Binance の BTC/USDT について、厚みの範囲を 1% としてオーダーブック指標を計算してください。」

期待される出力（JSON オブジェクト）：

{
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "bid_depth": 123.45,
  "ask_depth": 234.56,
  "imbalance": 0.1234,
  "mid_price": 50000.0,
  "timestamp": 1698765432000
}

例：複数の取引所のオーダーブックを比較する

プロンプト：「Binance、Kraken、OKX の BTC/USDT について、厚みの範囲を 1% としてオーダーブック指標を比較してください。」

期待される出力（Markdown テーブル）：

| exchange | bid_depth | ask_depth | imbalance |
|----------|-----------|-----------|-----------|
| binance  |    123.45 |    234.56 |    0.1234 |
| kraken   |     89.12 |    178.34 |    0.0987 |
| okx      |    145.67 |    256.78 |    0.1345 |

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。