binance-mcp-server

🚀 币安MCP服务器

币安MCP服务器是一个用于币安市场数据的Model Context Protocol (MCP) 服务器实现，支持WebSocket连接，能为用户提供便捷、稳定的市场数据服务。

🚀 快速开始

币安MCP服务器可通过简单的步骤启动并使用，为你提供币安市场的实时数据。

✨ 主要特性

• 🌐 实时市场数据流通过WebSocket传输，确保数据的及时性。
• 📈 支持现货和期货市场，满足不同交易场景需求。
• 🔄 自动重连机制带有指数回退，保障连接的稳定性。
• 🛡️ 类型安全的消息处理，提高数据处理的准确性。
• ⚠️ 全面的错误处理，降低系统故障风险。

📦 安装指南

在项目根目录下，使用以下命令进行安装：

npm install

💻 使用示例

基础用法

启动服务器

在安装完成后，使用以下命令启动服务器：

npm start

WebSocket流类型

支持以下流类型：

• trade：实时交易数据
• ticker：24小时滚动窗口价格变动统计
• bookTicker：最优买价/卖价及数量
• kline：烛台数据
• markPrice：标记价格和资金费率（仅限期货）
• fundingRate：资金费率数据（仅限期货）

高级用法

示例用法在Claude桌面

// 订阅BTCUSDT的交易和Ticker流
await server.subscribe('BTCUSDT', 'spot', ['trade', 'ticker']);

// 处理接收到的数据
server.onStreamData('BTCUSDT', 'trade', (data) => {
  console.log('新交易:', data);
});

📚 详细文档

开发

运行测试

在开发过程中，可使用以下命令运行测试：

npm test

构建

使用以下命令进行项目构建：

npm run build

📄 许可证

本项目采用专有许可证。