mcp-server-cex-bn

此 MCP 服务器为 Binance 现货交易操作提供了一个强大的接口。

中文说明

功能

交易操作

• 安全地配置和存储 Binance API 凭据
• 执行现货交易操作（限价/市价单）
• 监控账户余额
• 跟踪和管理未结订单
• 取消现有订单

工具

configure_api_keys

安全地存储您的 Binance 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 密钥

速率限制

• 遵守 Binance 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          # Binance API 集成
│   │   ├── keystore.ts         # API 密钥管理
│   │   └── tools.ts            # 交易工具实现
│   └── types/
│       ├── binance.ts          # Binance 类型
│       └── binance-connector.d.ts  # API 客户端类型
├── README.md
├── README_CN.md
├── package.json
├── pnpm-lock.yaml
└── tsconfig.json

开发

1. 设置环境变量：

在根目录中创建 .env 文件，并设置您的 Binance API 凭据：

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_secret_key_here

2. 安装依赖项：

pnpm install

构建服务器：

pnpm build

用于自动重建的开发：

pnpm watch

安装

1. 克隆存储库
2. 安装依赖项：

pnpm install

3. 在 .env 中配置您的 Binance API 凭据
4. 构建并启动服务器：

pnpm build
pnpm start

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

pnpm inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

mcp-server-bn