Binance MCP

🚀 Binance MCP 服務器

Binance MCP 服務器是一個與 Binance API 交互的工具集，支持 REST API 和 WebSocket 連接。它提供了一系列命令，可讓用戶獲取市場數據、訂閱即時更新以及管理 WebSocket 流。

🚀 快速開始

Binance MCP 服務器支持與 Binance API 的交互，藉助 REST API 和 WebSocket 連接，能滿足用戶對市場數據獲取、即時更新訂閱以及 WebSocket 流管理等需求。

✨ 主要特性

市場數據

• 獲取當前價格
• 查詢歷史數據
• 訂閱 K 線圖更新

24 小時交易統計

• 漲跌幅
• 成交量
• 最高價和最低價

即時 WebSocket 更新

• 訂閱即時成交信息
• 接收盤口深度更新
• 獲取最佳買價和賣價

💻 使用示例

基礎用法

# 檢查 Binance API 是否可達
is_connected = ping_binance()

# 獲取服務器當前時間（以毫秒為單位的紀元時間）
server_time = get_server_time()

高級用法

# 獲取比特幣當前價格
btc_price = get_price(symbol="BTCUSDT")

# 詳細查詢24小時交易統計
btc_stats = get_24hr_ticker(symbol="BTCUSDT")
print(f"比特幣價格變動百分比：{btc_stats['priceChangePercent']}%")
print(f"比特幣24小時成交量：{btc_stats['volume']} BTC")

# 獲取4小時時間窗口的滾動統計信息
btc_4h_stats = get_rolling_window_ticker(symbol="BTCUSDT", window_size="4h")
print(f"比特幣4小時價格變動百分比：{btc_4h_stats['priceChangePercent']}%")

高級用法

# 訂閱即時成交更新
trade_sub = subscribe_to_trade_stream(symbol="BTCUSDT")

# 一段時間後獲取最新成交數據
latest_trade = get_latest_stream_data(stream_name="btcusdt@trade")
print(f"最新成交價格：{latest_trade['data']['p']}")

# 訂閱5分鐘K線圖更新
kline_sub = subscribe_to_kline_stream(symbol="ETHUSDT", interval="5m")

# 清理所有訂閱
unsubscribe_from_stream(stream_name="btcusdt@trade")
unsubscribe_from_stream(stream_name="ethusdt@kline_5m")

📚 詳細文檔

項目結構

binance_mcp_server/  
├── binance_api.py       # 核心 REST API 交互模塊
├── binance_ws_api.py    # WebSocket 連接管理模塊
├── commands/            # MCP 命令定義  
│   ├── __init__.py  
│   ├── market_data.py   # 當前價格、歷史數據和訂單簿命令  
│   ├── market_info.py   # 交易所信息和元數據命令
│   └── websocket_streams.py  # WebSocket 流命令
└── server.py            # 主 MCP 服務器設置和初始化

擴展說明

添加新工具

要添加新的功能，可以在 binance_api.py 中創建相應的函數，並在其中一個命令模塊中註冊為 MCP 工具。

支持私有 API 端點

要支持經過身份驗證的 API 調用：

1. 修改 binance_api.py 以包含身份驗證
2. 創建額外的命令模塊用於交易操作
3. 在 server.py 中註冊新的命令

故障排除

• 連接問題：確保服務器正在運行後再嘗試連接客戶端
• 速率限制：Binance 可能會對過多 API 調用進行限流，需注意處理
• WebSocket 連接：檢查網絡狀態和代理設置，確保沒有干擾

術語表

• MCP：Machine Control Protocol（機器控制協議）
• REST API：基於 HTTP 的編程接口
• WebSocket：即時雙工通信協議

通過以上介紹，用戶可以全面瞭解如何使用 Binance MCP 服務器進行市場數據交互和管理。