mcp-服务器-cex-bn

该MCP服务器与币安的现货和期货交易业务提供全面整合。

中文说明

特征

现货交易操作

执行现货交易操作（限价/市价单）
监控账户余额
跟踪和管理未结订单
取消现有订单

期货交易操作

创建各种类型的期货订单（LIMIT、MARKET、STOP、TAKE_PROFIT 等）
管理杠杆设置（1-125倍）
监控期货仓位和账户信息
追踪融资利率
支持单向和对冲模式仓位
高级订单类型包括追踪止损和仅减少订单

工具

API 配置

`configure_api_keys`

安全存储您的 Binance API 凭证：

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

现货交易工具

`create_spot_order`

创建限价单或市价单：

// 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 密钥

期货交易安全

根据风险承受能力设定适当的杠杆限制
始终使用止损单来限制潜在损失
仔细监控清算价格
定期检查持仓风险和保证金比率
考虑使用仅减少订单进行风险管理
由于风险共担，对跨保证金需谨慎

速率限制

遵守币安 API 速率限制
默认速率限制：
- 每分钟 1200 个订单操作请求
- 每秒 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

安装依赖项：

pnpm install

构建服务器：

pnpm build

对于使用自动重建的开发：

pnpm watch

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Binance Trading Server：

npx -y @smithery/cli install mcp-server-cex-bn --client claude

手动安装

克隆存储库
安装依赖项：

pnpm install

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

pnpm build
pnpm start

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

pnpm inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

Integrations

mcp-服务器-cex-bn

特征

现货交易操作

期货交易操作

工具

API 配置

configure_api_keys

现货交易工具

create_spot_order

cancel_order

get_balances

get_open_orders