Kydlikebtc MCP Server Bn

🚀 mcp-server-cex-bn

該MCP服務器為幣安（Binance）現貨交易操作提供了強大的接口，能幫助用戶安全、便捷地進行交易操作，如配置API憑證、執行訂單、監控餘額等。

🚀 快速開始

按照以下步驟，您可以輕鬆開始使用MCP服務器進行幣安現貨交易：

1. 克隆倉庫：

git clone [url]
cd mcp-server-cex-bn

2. 配置API密鑰：編輯.env文件並添加您的幣安API憑證。
3. 啟動服務器：

npm start

✨ 主要特性

交易操作

• 配置並安全存儲幣安API憑證。
• 執行現貨交易操作（限價/市價訂單）。
• 監控賬戶餘額。
• 跟蹤和管理未完成訂單。
• 取消現有訂單。

工具

configure_api_keys

安全地存儲您的幣安API憑證：

await configureBinanceApiKeys({
  apiKey: 'your-api-key',
  apiSecret: 'your-api-secret'
});

create_spot_order

創建限價或市價訂單：

// 限價訂單
await createSpotOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.001',
  price: '40000'
});

// 市價訂單
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();
// 返回：{ BTC: '0.1', USDT: '1000', ... }

get_open_orders

列出所有未完成訂單：

const orders = await getOpenOrders({
  symbol: 'BTCUSDT' // 可選：指定符號
});

📚 詳細文檔

安全注意事項

• ⚠️ 重要提示
  • 永遠不要將API密鑰提交到版本控制中。
  • 使用環境變量或安全密鑰存儲。
  • 限制API密鑰權限，僅允許所需操作。
  • 定期輪換您的API密鑰。

速率限制

• 遵守幣安API的速率限制。
• 默認速率限制：
  • 每分鐘1200個請求用於訂單操作。
  • 每秒100個請求用於市場數據。
• 實現適當的錯誤處理以應對速率限制錯誤。

錯誤處理

常見錯誤場景：

• 無效的API憑證。
• 餘額不足。
• 無效的訂單參數。
• 速率限制超過。
• 網絡連接問題。

示例錯誤處理：

try {
  await createSpotOrder({
    symbol: 'BTCUSDT',
    side: 'BUY',
    type: 'LIMIT',
    quantity: '0.001',
    price: '40000'
  });
} catch (error) {
  if (error.code === -2010) {
    console.error('餘額不足');
  } else if (error.code === -1021) {
    console.error('速率限制超過');
  }
}

項目結構

.
├── src/
│   ├── index.ts                 # 服務器入口點
│   ├── services/
│   │   ├── binance.ts          # 幣安API集成
│   │   ├── keystore.ts         # API密鑰管理
│   │   └── spot_order.ts       # 現貨訂單處理
│   └── README.md               # 項目文檔
└── package.json                # 包配置文件

開發

1. 設置環境變量：

cp .env.example .env

2. 安裝依賴：

npm install

3. 構建和啟動服務器：

npm run build
npm start

4. 調試工具：使用MCP Inspector進行調試。