mcp-server-cex-bn
この MCP サーバーは、Binance のスポットおよび先物取引業務との包括的な統合を提供します。
中国語の説明
特徴
スポット取引業務
- スポット取引操作（指値/成行注文）を実行する
- 口座残高を監視する
- オープン注文の追跡と管理
- 既存の注文をキャンセルする
先物取引業務
- さまざまなタイプの先物注文（LIMIT、MARKET、STOP、TAKE_PROFIT など）を作成します
- レバレッジ設定を管理する（1～125倍）
- 先物ポジションと口座情報を監視する
- 資金調達率を追跡する
- 一方向とヘッジモードの両方のポジションをサポート
- トレーリングストップやリデュースオンリー注文などの高度な注文タイプ
ツール
API構成
Binance API の認証情報を安全に保存します。
await configureBinanceApiKeys({
apiKey: 'your-api-key',
apiSecret: 'your-api-secret'
});
スポット取引ツール
create_spot_order
LIMIT 注文または MARKET 注文を作成します。
// LIMIT order
await createSpotOrder({
symbol: 'BTCUSDT',
side: 'BUY',
type: 'LIMIT',
quantity: '0.001',
price: '40000'
});
// MARKET order
await createSpotOrder({
symbol: 'BTCUSDT',
side: 'BUY',
type: 'MARKET',
quantity: '0.001'
});
cancel_order
既存の注文をキャンセルする:
await cancelOrder({
symbol: 'BTCUSDT',
orderId: '12345678'
});
get_balances
アカウント残高を確認してください:
const balances = await getBalances();
// Returns: { BTC: '0.1', USDT: '1000', ... }
get_open_orders
すべてのオープン注文を一覧表示します:
const orders = await getOpenOrders({
symbol: 'BTCUSDT' // Optional: specify symbol
});
先物取引ツール
create_futures_order
さまざまな種類の先物注文を作成します。
// LIMIT order
await createFuturesOrder({
symbol: 'BTCUSDT',
side: 'BUY',
type: 'LIMIT',
quantity: '0.001',
price: '40000',
timeInForce: 'GTC'
});
// STOP MARKET order
await createFuturesOrder({
symbol: 'BTCUSDT',
side: 'SELL',
type: 'STOP_MARKET',
quantity: '0.001',
stopPrice: '38000'
});
// TRAILING STOP order
await createFuturesOrder({
symbol: 'BTCUSDT',
side: 'SELL',
type: 'TRAILING_STOP_MARKET',
quantity: '0.001',
callbackRate: '1.0' // 1% callback rate
});
set_futures_leverage
取引ペアのレバレッジを調整します。
await setFuturesLeverage({
symbol: 'BTCUSDT',
leverage: 10 // 1-125x
});
get_futures_positions
すべてのオープン先物ポジションを取得します。
const positions = await getFuturesPositions();
get_futures_account
詳細な先物口座情報を取得します。
const account = await getFuturesAccount();
get_funding_rate
先物シンボルの資金調達率を取得します。
const fundingRate = await getFundingRate({
symbol: 'BTCUSDT'
});
cancel_futures_order
既存の先物注文をキャンセルする:
await cancelFuturesOrder({
symbol: 'BTCUSDT',
orderId: '12345678'
});
先物取引の詳細
位置モード
- 一方向モード: シンボルごとに単一の位置
- デフォルトモード、よりシンプルなポジション管理
- 総ポジションサイズはすべての注文の合計です
- ヘッジモード: ロングポジションとショートポジションを分離
- ロングポジションとショートポジションを同時に保持できる
- 各ポジションには独立した証拠金要件がある
マージンの種類
- 分離マージン: ポジションごとに固定マージン
- リスクは割り当てられたマージンに限定されます
- 各ポジションには独自のレバレッジ設定があります
- クロスマージン: ポジション間で共有されるマージン
資金調達率
永久先物契約では、資金調達率を使用して先物価格をスポット価格と一致させます。
- プラス金利：ロングがショートを支払う
- マイナス金利：ショートがロングに有利
- 支払いは8時間ごとに行われます
セキュリティに関する考慮事項
スポット取引のセキュリティ
- APIキーをバージョン管理にコミットしない
- 環境変数または安全なキーストレージを使用する
- APIキーの権限を必要な操作のみに制限する
- APIキーを定期的にローテーションする
先物取引セキュリティ
- リスク許容度に基づいて適切なレバレッジ制限を設定する
- 潜在的な損失を制限するために、常にストップロス注文を使用してください。
- 清算価格を注意深く監視する
- ポジションリスクと証拠金比率を定期的にチェックする
- リスク管理のために減額注文の使用を検討する
- リスク共有のためクロスマージンには注意が必要
レート制限
- Binance APIのレート制限を尊重する
- デフォルトのレート制限:
- 注文操作のリクエストは1分あたり1200件
- 市場データに対する1秒あたり100件のリクエスト
- レート制限エラーに対する適切なエラー処理を実装する
エラー処理
よくあるエラーのシナリオ
- 無効なAPI認証情報
- 残高または証拠金が不足している
- 無効な注文パラメータ
- レート制限を超えました
- ネットワーク接続の問題
先物特有のエラー
- InsufficientMarginError: 操作に必要なマージンが足りません
- InvalidPositionModeError: 位置モードの設定が間違っています
- OrderValidationError: 先物注文パラメータが無効です
エラー処理の例:
try {
await createFuturesOrder({
symbol: 'BTCUSDT',
side: 'BUY',
type: 'LIMIT',
quantity: '0.001',
price: '40000',
timeInForce: 'GTC'
});
} catch (error) {
if (error instanceof InsufficientMarginError) {
console.error('Insufficient margin available');
} else if (error instanceof InvalidPositionModeError) {
console.error('Invalid position mode');
} else if (error instanceof OrderValidationError) {
console.error('Invalid order parameters');
}
}
プロジェクト構造
.
├── src/
│ ├── index.ts # Server entry point
│ ├── services/
│ │ ├── binance.ts # Binance API integration
│ │ ├── keystore.ts # API key management
│ │ └── tools.ts # Trading tools implementation
│ └── types/
│ ├── binance.ts # Binance types
│ └── binance-connector.d.ts # API client types
├── README.md
├── README_CN.md
├── package.json
├── pnpm-lock.yaml
└── tsconfig.json
発達
- 環境変数を設定します。
ルートディレクトリに.envファイルを作成し、Binance API の資格情報を設定します。
BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_secret_key_here
- 依存関係をインストールします:
サーバーを構築します。
自動リビルドを使用した開発の場合:
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Binance Trading Server を自動的にインストールするには:
npx -y @smithery/cli install mcp-server-cex-bn --client claude
手動でインストールする
- リポジトリをクローンする
- 依存関係をインストールします:
.envでBinance APIの認証情報を設定する- サーバーをビルドして起動します。
デバッグ
MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。
インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。
mcp-server-bn