Crypto Orderbook MCP

一个分析主要加密货币交易所订单簿深度和不平衡的MCP服务器，为AI代理和交易系统提供实时市场结构洞察。

特性

• 订单簿指标：计算指定交易对在给定交易所的买单/卖单深度和不平衡。
• 跨交易所比较：在统一的Markdown表格中比较多个交易所的订单簿深度和不平衡。
• 支持的交易所：币安、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" ]
     } 
   }
   

使用

该服务器提供了两个主要工具：

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文件。