大手暗号取引所で注文書の深さと不均衡を分析するMCPサーバー。リアルタイム市場構造の洞察をAIエージェントと取引システムに活用できます。

##特徴

• オーダーブックメトリクス:特定の取引ペアの入札/アスク深さと不均衡を計算します。
• 十字交換の比較: 統一されたMarkdownテーブルで複数の取引所で注文書の深さと不均衡を比較します。
• サポートされた交換: Binance、Kraken、コインベース、Bitfinex、Okx、Bybit

インストール

前提条件

• Python 3.10以上
• uv(Pythonパッケージとプロジェクトマネージャ)

セットアップ

1. リポジトリのクローン

2.依存関係のインストール

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

3。MCPクライアント(Claude Desktop)の設定

使用法

サーバは2つの主要なツールを提供しています。

1.[calculate_orderbook: 入札深さを計算します。, 深さを尋ねます。, 特定の取引所での取引ペアの不均衡. 2.[compare_orderbook: 入札深さを比較し、深さを尋ね、複数の取引所に不均衡を要求し、Markdownテーブルを返します。

##例:オーダーブックメトリックの計算

Crypto Orderbook MCP

An MCP server that analyzes order book depth and imbalance across major crypto exchanges, empowering AI agents and trading systems with real-time market structure insights.

Features

• Order Book Metrics: Calculate bid/ask depth and imbalance for a specified trading pair on a given exchange.
• Cross-Exchange Comparison: Compare order book depth and imbalance across multiple exchanges in a unified Markdown table.
• Supported Exchanges: Binance, Kraken, Coinbase, Bitfinex, Okx, Bybit

Installation

Prerequisites

• Python 3.10 or higher
• uv (Python package and project manager)

Setup

1. Clone the Repository

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

2. Install Dependencies

   Use uv to install the required packages:

   uv sync
   

3. Configure the MCP Client(Claude Desktop)

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

Usage

The server provides two main tools:

1. calculate_orderbook: Computes bid depth, ask depth, and imbalance for a trading pair on a specified exchange.
2. compare_orderbook: Compares bid depth, ask depth, and imbalance across multiple exchanges, returning a Markdown table.

Example: Calculate Order Book Metrics

Prompt: “Calculate the order book metrics for BTC/USDT on Binance with a 1% depth range.”

Expected Output (JSON object):

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

Example: Compare Order Book Across Exchanges

Prompt: “Compare the order book metrics for BTC/USDT across Binance, Kraken, and OKX with a 1% depth range.”

Expected Output (Markdown table):

| 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 |

License

This project is licensed under the MIT License. See the LICENSE file for details.