Model Context Protocol · Streamable HTTP

把 BLE 开发中的高频计算与查询交给 AI

这是一个 MCP 服务:把你的 AI 助手接到下面这个端点,它就能直接解析广播包、查 GATT UUID、 校验连接参数、翻译 HCI 错误码 —— 不用再在手册和抓包工具之间来回切。

服务端点 https://mcp-ble.yinglintech.com/mcp

工具

全部基于蓝牙 SIG 公开规范与核心规范实现,不依赖任何私有数据。遇到未收录的值会如实返回 unknown,不猜测。

广播数据解析 可用

parse_adv_data

粘贴一段广播包的十六进制,返回逐条 AD 记录的完整解码:Flags、设备名、Appearance、16/128 位服务 UUID、厂商自定义数据。同时报告截断与长度越界。

GATT UUID 查询 可用

lookup_gatt_uuid

16 位与 128 位 UUID 互转,查询标准服务、特征、描述符的官方名称。自定义 128 位 UUID 会明确标注为「SIG 未分配」。

连接参数校验 建设中

validate_connection_params

校验连接间隔 / 从机延迟 / 监督超时是否满足规范约束,并对照 Apple、Google 平台侧的隐性要求给出结论。

功耗估算 建设中

estimate_adv_power

按广播间隔与三通道占空比估算平均电流,用于快速判断某个广播配置是否撑得住纽扣电池的寿命要求。

HCI 错误码查询 建设中

lookup_hci_error

按错误码查含义与常见成因,覆盖 HCI Error Code 与断开原因(Reason Code)两套编号。

抓包日志解析 建设中

parse_hci_log

把 HCI 或串口抓包日志按事件类型归类,标出连接建立、参数更新、断开的原因链。调试间歇性断连时最省时间的一步。

芯片公开参数查询 建设中

lookup_chip_param

查询 CMT453x、N32WB033 等芯片的公开 datasheet 参数:内核、Flash / SRAM 容量、BLE 版本、射频指标、外设资源、封装与供电范围。每条数据标注来源,不收录未经验证的内容。

接入方式

任何支持远程 MCP(Streamable HTTP)的客户端都能接。下面是两种最常见的配法。

Claude / ChatGPT 网页版

  1. 进入客户端的 Connectors / 连接器设置
  2. 新增自定义连接器,类型选「远程 MCP」
  3. URL 填 https://mcp-ble.yinglintech.com/mcp
  4. 保存后即可在对话中直接使用工具

鉴权方式接入后按客户端提示完成。

本地客户端(stdio 配置)

支持直接配置远程 URL 的客户端,用上面的地址即可。若客户端只吃 stdio 配置,可用 mcp-remote 做桥接:

{
  "mcpServers": {
    "ble-assistant": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp-ble.yinglintech.com/mcp"
      ]
    }
  }
}

端点与协议

项目
MCP 端点https://mcp-ble.yinglintech.com/mcp
传输方式Streamable HTTP(POST + 可选 SSE 流)
会话模式无状态(每请求独立,支持重启与横向扩展)
站点首页https://mcp-ble.yinglintech.com/
健康检查GET /health

服务器在新加坡(腾讯云),大陆访问延迟略高但对协议通信无影响。

进度

先把链路跑通,再逐个补齐工具能力。

站点与 MCP 端点上线
容器化部署、HTTPS、Streamable HTTP 端点可握手 —— 已完成。
广播解析与 UUID 查询
两个纯计算工具,基于公开规范实现,已可用。
连接参数校验与功耗估算
把踩过的坑固化成规则:规范约束 + Apple / Google 平台隐性限制。
错误码与抓包日志解析
HCI 错误码表 + 抓包日志归因,用于快速定位间歇性断连。
OAuth 2.1 鉴权
按 MCP 授权规范接入授权服务器,支持受保护资源元数据与动态客户端注册。