Qeinfinity Binance MCP Server

🚀 币安 MCP 服务器

本项目是一个用于币安市场数据的模型上下文协议（MCP）服务器实现，支持 WebSocket 连接，能为用户提供实时、稳定且类型安全的市场数据服务。

🚀 快速开始

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

安装

在项目根目录下执行以下命令进行依赖安装：

npm install

启动服务器

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

npm start

✨ 主要特性

• 🌐 实时市场数据流经 WebSocket，让你第一时间获取市场动态。
• 📈 支持现货和期货市场，满足不同交易场景需求。
• 🔄 自动重连功能带有指数回退，确保连接稳定。
• 🛡️ 类型安全的消息处理，提高数据处理的准确性。
• 🛠️ 全面的错误处理，保障系统的健壮性。

📦 安装指南

在项目根目录下运行以下命令完成依赖安装：

npm install

💻 使用示例

基础用法

WebSocket 流类型

支持以下流类型：

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

示例代码

在 Claude 桌面的示例用法如下，可订阅 BTC/USDT 的交易和 Ticker 流，并处理接收到的数据：

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

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

📚 详细文档

开发

运行测试

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

npm test

构建

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

npm run build

📄 许可证

本项目采用私有许可证。