MiBandMCP 项目归档说明

MiBandMCP 是我出于个人兴趣开发的本地优先 Android 工具，现在已经结束并归档。它尝试把 Gadgetbridge 导出的小米手环数据整理为标准接口，再通过局域网 MCP 服务提供给客户端。这个项目不直接连接手环，也不接入云服务；蓝牙通信和数据库导出仍由 Gadgetbridge 负责，MiBandMCP 只读取用户选择的最新导出快照。

实现与取舍

项目使用 Kotlin 开发，构建环境基于 JDK 17 和 Android SDK 37，支持 Android 8.0 及以上版本。应用可以启动或停止前台 MCP 服务，展示当前服务与数据状态，并通过 Gadgetbridge 的 Intent API 请求同步和数据库导出。MCP 接口提供步数、心率、睡眠等快照数据，也保留工具形式的访问方式，以兼容尚未完整支持 MCP Resources 的客户端。

数据链路刻意保持简单：手环数据先进入 Gadgetbridge，再导出 SQLite，最后由应用读取为统一快照。刷新采用显式触发的近实时同步，而不是连续数据流；当前实现只面向单个 Gadgetbridge 设备和一份用户选择的导出文件。服务没有身份验证，因此只适合运行在可信局域网中。这些限制缩小了项目边界，也避免把兴趣探索扩展成更复杂的账户、云同步或历史数据库系统。

归档

个人兴趣探索已经告一段落，项目不再继续开发。仓库会保留代码、接口说明和安全边界，作为一次 Android、Gadgetbridge 与 MCP 组合实践的记录。它帮助我验证了用本地优先方式把穿戴设备快照交给其他客户端的基本链路；归档后，它的定位就是这段探索过程的技术资料，而不是仍在维护中的产品。