Binance MCP

🚀 Binance MCP サーバー

Binance MCP サーバーは、Binance API との相互作用を可能にするツールセットです。REST API と WebSocket 接続の両方をサポートしています。このサーバーは、市場データの取得、リアルタイム更新の購読、WebSocket ストリームの管理など、さまざまなコマンドを提供しています。

🚀 クイックスタート

Binance MCP サーバーを使うことで、Binance API とのやり取りが容易になります。このサーバーを通じて、市場データの取得やリアルタイム更新の購読が可能です。

✨ 主な機能

市場データ

• 現在の価格を取得
• 過去のデータを照会
• 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']}%")

WebSocket ストリームの管理

# リアルタイムの取引更新を購読
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 サーバーを使って市場データのやり取りと管理を行うことができます。