Xiaomi Band MCP · ChatGPT Work + Sites

用 ChatGPT Work + Sites、TypeScript Worker 和 Sites D1 搭建自己的小米运动健康云端数据接口，并让 ChatGPT 通过 Sites 原生 MCP 查询数据、按需同步。

项目定位：读取、同步、保留与准确提供数据。健康分析交给 ChatGPT。 不开发新的服务端健康评分或训练结论；当前兼容接口中已有的简单统计予以保留。

这是当前可运行实现的脱敏开源快照，不含个人数据库、真实健康样本、账号凭据、站点 ID 或私有 Git 历史。公开的是代码；你部署的健康数据 Site 必须保持所有者私有。

架构

flowchart TD
  Band[小米手环] --> App[小米运动健康 App]
  App --> Cloud[中国区小米云]
  Cloud --> Worker[所有者私有 Sites Worker]
  Worker --> D1[Sites D1 原始记录与缓存]
  D1 --> MCP[Sites 原生 MCP]
  MCP --> AI[ChatGPT 读取和分析]
  D1 --> Dashboard[六页面 Dashboard]

App 需要先把手环数据上传到云端；MCP 不连接蓝牙，不控制手机同步。今天的数据始终视为未完整。Windows 仅在首次本地认证或配置时可能使用，不需要持续开机。

Related MCP server: Mi Fitness Data Bridge

已实现与边界

没有实现完整原始 JSON 的 MCP 透传。 普通查询返回规范化字段；运动 operational 详情还存在字段过滤、数组截断等限制。详见 已知限制。

复现前提

• 你自己的小米大陆账号、小米运动健康 App，以及能用的 userId / passToken。

• 当前账户实际具有 ChatGPT Work + Sites、D1、环境 Secrets、原生 MCP 插件 能力。是否可用以账户界面为准；不保证仅购买某种套餐就必然开放这些能力。

• 本地检查建议 Node.js 22 或24、npm；这些是开发工具，不是线上运行条件。

• 本项目使用未公开稳定承诺的私有接口；认证、数据类型及网络可达性可能变化。不会绕过验证码、二次验证或其他安全机制。

• 本仓库不代购服务、不创建付费资源。Sites/数据库/自动化的额度和计费取决于平台及账户，不能保证永久免费。

本地检查：不连接小米

git clone https://github.com/hao0527/xiaomi-band-mcp-sites.git
cd xiaomi-band-mcp-sites
npm ci
npm run typecheck
npm test

测试全部使用合成数据或 Mock 传输，不需要 Secrets，不进行真实小米登录。构建结果为 worker/index.js 与 dist/server/index.js；.openai/hosting.json 声明 D1 DB 和 mcp。不要把开发时可伪造身份头的本地环境暴露到互联网。

在 ChatGPT Work 中复现

按 完整部署指南 操作。可以先把 复现提示词 发给拥有 Sites 工具的 ChatGPT Work，并提供本仓库链接。

1. 读取仓库，执行合成测试。

2. 新建一个所有者唯一访问的 Site，使用新的 Sites 项目 ID；本仓库故意未带 project_id，不能复用他人的 ID。

3. 按序应用 drizzle/0000—0003 空库迁移，声明 D1 DB 与原生 mcp；构建并通过 Sites 正规流程私有部署。不要重复执行 db/schema.sql 和迁移，两者是替代初始化路径。

4. 在该 Site 的后端环境设置中配置 MI_USER_ID、MI_PASS_TOKEN，都设为 Secret。聊天中不要发送凭据，也不要让 Work 读取环境值。

5. 设置 PERSIST_SYNC_ENABLED=true 后重新部署。由你明确授权首次同步；先检查认证与最近两天结果，再决定是否跑历史回填。

6. 使用 Sites 发布时创建的个人 MCP 插件；工具未出现时刷新连接或新建对话。先读 get_sync_status，再按需调用 trigger_sync。

7. 可选：确认平台额度后配置云端定时任务，见 自动同步。本仓库本身不会创建定时任务。

不要部署为公开 Site，也不要原样部署到无身份保护的公开 Cloudflare Worker。 /api/sync 等后台入口依赖 Sites 平台所有者私有访问边界；意图头不是认证凭据。

首次账号凭据

本仓库不含密码登录、验证码处理、自动 Cookie 提取器或账号登录页面。请仅在你控制的本地环境按参考项目作者说明取得自己账号的凭据，参见 Aaron-gx/mihealth-api 的登录说明。它是独立第三方工具，运行前自行审查；不要把其密码命令、配置文件或成功认证响应发到 ChatGPT 或 GitHub。

登录 mi.com 并不自动证明已经获得健康服务会话。本后端实际需要 MI_USER_ID 与 MI_PASS_TOKEN；ssecurity 和 serviceToken 在后端会话中交换，不需要上传为额外配置，也不保存到D1。被安全验证拦截时停止，在官方登录界面完成必要验证，不自动重试或绕过。

MCP工具

共有19项工具，见 工具清单与调用流程。常用：

• trigger_sync、get_sync_progress、get_sync_status

• list_available_metrics、get_metric_records

• get_daily_summary、get_sleep_records、get_heart_rate

• get_activity_records、get_activity_detail

• get_activity_heart_rate_samples：通过 next_offset 读完整缓存曲线

查询工具只读取 D1 缓存；trigger_sync 是唯一标为写入的 MCP 工具。AI应主动把“缓存没有数据”“尚未同步”“云端成功返回空结果”和“接口失败”分开，不编造缺失指标。

目录

贡献与后续方向

优先处理实际字段丢失、缓存可读性、已知渠道覆盖和历史完整性。保留未知原值，不猜单位；不为了扩展架构而重写正常功能，也不为了工具数量增加接口。当前实现保留兼容摘要/分析入口，但不把它们作为未来开发重点。

MIT，详见 LICENSE 与 NOTICE.md。保留全部上游版权声明。与小米或 OpenAI 无隶属或背书关系。