Qeinfinity Binance MCP Server

🚀 币安 MCP 服务器

本项目是一个用于币安市场数据的模型上下文协议（MCP）服务器实现，支持 WebSocket 连接，可助力用户高效获取币安市场的各类数据。

🚀 快速开始

币安 MCP 服务器为你提供便捷的币安市场数据获取途径。你可通过以下步骤快速启动服务器：

npm install
npm start

✨ 主要特性

• 实时市场数据流经 WebSocket，让你实时掌握市场动态。
• 支持现货和期货市场，满足不同交易场景需求。
• 自动重连功能带有指数回退，保障数据传输的稳定性。
• 类型安全的消息处理，确保数据处理的准确性。
• 全面的错误处理，让你在使用过程中更安心。

📦 安装指南

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

npm install

💻 使用示例

基础用法

启动服务器

npm start

WebSocket 流类型

支持以下流类型：

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

高级用法

示例用法在 Claude 桌面

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

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

📚 详细文档

开发

运行测试

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

npm test

构建

若要构建项目，可执行以下命令：

npm run build

📄 许可证

本项目使用私有许可证。