binance-mcp-openclaw

基于 Spring Boot 的 ETH/USDT 价格预警机器人，通过 Binance WebSocket 实时监控价格，在 QQ 群内发送预警通知，并以 MCP Server 形式供 AI 助手（如 openclaw）调用。

功能

• 实时监控 ETH/USDT 价格（Binance WebSocket）
• QQ 群内通过 @机器人 eth预警 指令管理预警
• 价格触发时 @ 用户发送群通知，触发后进入冷却期防止刷屏
• 以 MCP Server 暴露工具接口，供 AI 助手直接调用

架构

Binance WebSocket
    └─> BinancePriceListener
            └─> AlertCheckService.check(price)
                    ├─> AlertStore（内存存储）
                    └─> QQNotifyService.sendGroupMsg()（触发时通知）

NapCat HTTP 回调 POST /napcat/event
    └─> NapCatEventController（过滤 @机器人 消息）
            └─> AlertCommandHandler（解析 eth预警 指令）
                    ├─> AlertStore
                    └─> QQNotifyService

MCP Server（SSE，供 openclaw 等 AI 助手接入）
    └─> BinanceAlertMcpTools
            ├─> getCurrentEthPrice
            ├─> addPriceAlert
            ├─> listPriceAlerts
            └─> deletePriceAlert

快速开始

环境要求

• Java 21
• Maven（或使用项目内置的 ./mvnw）

配置

复制配置模板并填入真实值：

cp src/main/resources/application.yaml src/main/resources/application-local.yaml

编辑 application-local.yaml：

alert:
  qq-bot-api: http://你的NapCat地址:3000
  bot-qq: 机器人QQ号
  qq-user-id: 默认通知的QQ号
  napcat-token: NapCat的Bearer Token

运行

# 使用本地配置文件启动
JAVA_HOME=/path/to/jdk-21 ./mvnw spring-boot:run -Dspring-boot.run.profiles=local

# 或通过环境变量配置
QQ_BOT_API=http://... BOT_QQ=... NAPCAT_TOKEN=... ./mvnw spring-boot:run

构建

./mvnw clean package -DskipTests
java -jar target/binance-0.0.1-SNAPSHOT.jar

QQ 指令

在 QQ 群内 @ 机器人发送以下指令：

| 指令 | 说明 | |------|------| | eth预警 上 2500 止盈 | 价格突破 $2500 时通知 | | eth预警 下 1900 止损 | 价格跌破 $1900 时通知 | | eth预警 列表 | 查看我的预警列表 | | eth预警 删除 <ID前8位> | 删除指定预警 | | eth预警 帮助 | 显示使用说明 |

MCP Server 接入

服务启动后，AI 助手可通过 SSE 协议接入：

http://你的服务器IP:8080/sse

openclaw 配置示例：

{
  "mcpServers": {
    "binance-alert": {
      "url": "http://你的服务器IP:8080/sse"
    }
  }
}

接入后 AI 助手可使用以下工具：

| Tool | 说明 | |------|------| | getCurrentEthPrice | 查询 ETH 当前实时价格 | | addPriceAlert | 为指定 QQ 用户添加价格预警 | | listPriceAlerts | 查询用户的预警列表 | | deletePriceAlert | 删除指定预警 |

REST API

服务同时提供 HTTP 管理接口：

| 方法 | 路径 | 说明 | |------|------|------| | GET | /api/alerts/{userId} | 查询用户预警 | | POST | /api/alerts/{userId} | 添加预警 | | DELETE | /api/alerts/{userId}/{alertId} | 删除预警 | | POST | /api/alerts/{alertId}/reset | 重置冷却状态 |

配置项

| 配置项 | 默认值 | 说明 | |--------|--------|------| | alert.binance-ws-url | wss://stream.binance.com:9443/ws/ethusdt@ticker | Binance WebSocket 地址 | | alert.qq-bot-api | — | NapCat HTTP API 地址 | | alert.bot-qq | — | 机器人自身 QQ 号 | | alert.napcat-token | — | NapCat Bearer Token（可选） | | alert.cooldown-seconds | 300 | 预警触发后冷却时间（秒） |

技术栈

• Spring Boot 4.0.5
• Spring AI MCP Server 2.0.0-M3
• OkHttp（Binance WebSocket）
• NapCat / OneBot v11 协议