Binance MCPサーバー
概要
Binance MCPサーバーは、Binance APIと連携するために設計されたバックエンドサービスです。Binance取引所とのシームレスな連携を可能にし、ユーザーはポートフォリオの閲覧、トークンの変換、そして市場への影響を最小限に抑えた取引の実行が可能になります。このサーバーは、モデルコンテキストプロトコル（MCP）フレームワークを活用し、安全で構造化された効率的なトランザクションを実現します。
主な機能:
- アカウント情報や取引についてはBinance取引所APIと連携してください
- ポートフォリオの構成と評価を表示する
- 市場への影響を軽減しながらスマートトークン変換を実行する
- 市場注文とアルゴリズム取引戦略を処理する
- リアルタイムの取引データとアカウント情報を取得する
- モデルコンテキストプロトコルフレームワークを使用して構造化トランザクションを実装する
- Binanceとの統合のための安全な認証とAPIキー管理を提供する
特徴
- [x] Binance API統合：アカウント情報と取引操作のためにBinance取引所に接続します
- [x]ポートフォリオ管理: 詳細なポートフォリオ構成、市場価値、および割合の割り当てを表示します。
- [x]ポートフォリオ分析: オプションの履歴値追跡により、時間の経過に伴うパフォーマンスを監視
- [x]スマートトークン変換：インテリジェントな注文執行戦略でトークンを変換
- [x]市場インパクトの緩和：大口注文に対して自動的にアルゴリズム取引を使用し、価格の下落を防ぐ
- [x]アカウント管理: 詳細なアカウント情報、残高、取引履歴を取得します
- [x]市場データアクセス：情報に基づいた取引決定のために、リアルタイムの注文書と市場データにアクセスします。
- [x]注文執行: 柔軟な数量指定でスポット市場注文を出す
- [ ]アルゴリズム取引サポート：市場への影響を最小限に抑えるために時間加重平均価格（TWAP）注文を実装します
- [ ]自動取引：事前に定義された戦略に基づいてプログラムで取引を実行する
- [ ]安全な認証：APIキーを管理し、Binanceサービスへの安全な接続を実現します。
- [ ]包括的なエラー処理:トランザクションの失敗やAPIの問題に関する詳細なエラーレポート
要件
Binance MCP サーバーをセットアップする前に、以下がインストールされていることを確認してください。
- Node.js (v16以降)
- npmまたはyarn
- Binance APIキーとシークレット（Binance取引所との統合用）
- 有効なBinance Smart Chain（BSC）ウォレットの秘密鍵（ブロックチェーン取引用）
インストール
リポジトリをクローンし、依存関係をインストールします。
git clone https://github.com/your-repo/binance-mcp-server.git
cd binance-mcp-server
yarn install # or npm install
構成
サーバーを構成するには、ルート ディレクトリに.envファイルを作成し、次の変数を指定します。
# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here
Binance APIキーの作成
Binance API統合を使用する前に、APIキーを作成する必要があります。これにより、複数のプログラミング言語を使用してBinanceのサーバーに接続し、Binanceからデータを取得し、外部アプリケーションとやり取りできるようになります。ウォレットと取引データの確認、取引の実行、サードパーティ製プログラムでの資金の入出金が可能になります。
前提条件:
- アカウントを有効にするには、Spot Walletに任意の金額を入金する必要があります。
- 本人確認を完了する
- アカウントで2要素認証（2FA）を有効にする
Binance APIキーを作成する手順:
- Binanceアカウントにログインし、プロフィールアイコンをクリックしてから[アカウント]をクリックします。
- [API 管理] に移動し、[API の作成] をクリックします。
- 希望する API キーの種類を選択してください:
- システム生成 API キー (HMAC 対称暗号化) - API キーと秘密キーを取得します。
- 自己生成 API キー (Ed25519 または RSA 非対称暗号化) - API キーを受け取りますが、独自の公開キーと秘密キーのペアを作成する必要があります。
- API キーのラベル/名前を入力します。
- 2FA デバイスとパスキーで認証します。
- API キーが作成されました。
Binance API の詳細については、 Binance API ドキュメントを参照してください。
Claude Desktop との統合 (複数の MCP サーバー用)
MCP サーバーを Claude Desktop と統合する前に、以下がインストールされていることを確認してください。
すべての MCP サーバーをビルドするには、monorepo のルートから次のコマンドを使用します。
Claudeデスクトップの設定
各MCPサーバーは独自の構成を持っています。個々のMCPサーバーを統合するには、以下の手順に従います。
- MCP サーバー フォルダー (例:
packages/binance-spot-mcp ) に移動します。 config.example.jsonファイルを開きます。- このファイルの内容を使用して、Claude Desktop 構成内にエントリを作成します。
Claude デスクトップ設定ファイルの場所
| プラットフォーム | パス |
|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| ウィンドウズ | %APPDATA%\Claude\claude_desktop_config.json |
| リナックス | ~/.config/Claude/claude_desktop_config.json |
設定エントリの例
1 つの MCP サーバー ( binance-spot-mcp ) は次のようになります。
{
"mcpServers": {
"binance-spot-mcp": {
"command": "node",
"args": ["/Users/Username/Desktop/binance-mpc/packages/packages/binance-spot-mcp/build/index.js"],
"env": {
"BINANCE_API_KEY": "BINANCE_API_KEY",
"BINANCE_API_SECRET": "BINANCE_API_SECRET"
},
"disabled": false,
"autoApprove": []
}
}
}
注意: argsパスをbuild/index.jsの実際の場所に置き換え、そのサーバーのconfig.example.jsonからenv値をコピーしてください。
新しい設定を有効にするには、Claude Desktop を再起動します。
使用方法（Claude以外のMCPホストに接続する場合）
ニーズに応じて、MCP サーバーを起動するための3 つのオプションがあります。
オプション1: すべてのMCPサーバーをビルドして起動する
yarn build # Step 1: Build all packages
yarn start # Step 2: Start all MCP servers concurrently
オプション2: すべてのMCPサーバーを1ステップで構築して起動する
yarn server # This builds and runs all MCP servers in one go
オプション3: 特定のMCPサーバーを実行する
個々のサーバーを実行するには、次のコマンドを使用します。
yarn server:<mcp-server-name>
🔸 例:
yarn server:binance-spot-mcp
機能
Binance API関数
- Binanceアカウント情報を取得する -
binanceAccountInfo残高、取引権限、アカウントステータスなど、Binance アカウントに関する包括的な情報を取得します。 - Binanceアカウントスナップショットを取得 -
binanceAccountSnapshotBinanceアカウントのステータス（現在のBTC価格情報を含む）のスナップショットを取得します。過去30日間の履歴も含まれます。 - Binanceの注文書を確認する -
binanceOrderBook指定された取引ペアの現在の注文書を取得し、最大 50 レベルの深さまでの利用可能な売買注文を表示します。 - スポット市場注文の発注 -
binanceSpotPlaceOrder{
"symbol": "BTCUSDT",
"side": "BUY",
"quantity": 0.001,
// OR
"quoteOrderQty": 100
}
quantityでベース資産の数量を指定するか、 quoteOrderQtyで建値通貨での数量を指定します。小口注文に適しています。 - TWAP注文を出す -
binanceTimeWeightedAveragePriceFutureAlgo{
"symbol": "BTCUSDT",
"side": "BUY",
"quantity": 1.0,
"duration": 3600
}
モデルコンテキストプロトコル（MCP）
**モデルコンテキストプロトコル（MCP）は、**アプリケーションとAIモデルおよびブロックチェーンベースの計算システムとの連携を強化するために設計されたオープンスタンダードです。MCPは、自動トランザクションと分散型アプリケーションの効率を向上させる構造化されたコンテキストを確立します。
MCP の利点:
- 標準化: アプリケーションの相互作用に対する統一されたアプローチを定義します。
- 効率: 計算オーバーヘッドが削減され、トランザクション速度が向上します。
- 相互運用性: 複数のプラットフォームとブロックチェーン エコシステム間の統合をサポートします。
エラー処理
トランザクションが失敗すると、サーバーは詳細を含むエラーメッセージを返します。詳細なデバッグ情報については、コンソールログを確認してください。一般的なエラーシナリオには以下が含まれます。
- ウォレットの残高が不足しています
- 受信者のアドレスが無効です
- ネットワークの輻輳またはRPCの問題
- Binance API認証エラー
- 取引制限
ライセンス
このプロジェクトは MIT ライセンスに基づくオープンソースです。
貢献、バグ報告、機能リクエストについては、 GitHubで問題を送信してください。