工具
全部基于蓝牙 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 网页版
- 进入客户端的 Connectors / 连接器设置
- 新增自定义连接器,类型选「远程 MCP」
- URL 填
https://mcp-ble.yinglintech.com/mcp - 保存后即可在对话中直接使用工具
鉴权方式接入后按客户端提示完成。
本地客户端(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 |
服务器在新加坡(腾讯云),大陆访问延迟略高但对协议通信无影响。
进度
先把链路跑通,再逐个补齐工具能力。