the-momentum/open-wearables

这是什么？

核心功能

• 01统一 REST API，将云端与 SDK 类可穿戴数据源的数据标准化。
• 02内置 MCP 服务器，可供 Claude、Cursor 等客户端查询穿戴设备数据。
• 03Webhook 支持事件过滤、签名校验和投递记录查看。
• 04支持导入 Apple Health XML 导出文件，大文件可通过 S3 分片上传。
• 05提供 iOS、Android、Flutter 和 React Native 原生 SDK，用于同步手机端健康数据。
• 06通过 Docker Compose 一键启动，并提供管理后台用于管理 API 密钥、用户和同步状态。

适用场景

• 为 AI 健康教练提供用户真实的睡眠和训练数据作为依据。
• 为医疗或健康类应用汇总患者或用户的穿戴设备数据。
• 为科研项目收集多种设备的标准化健康数据。
• 在自己的服务器上搭建个人穿戴数据库，并通过 MCP 客户端查询。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/the-momentum/open-wearables.git
2. 2

   进入项目目录

   cd open-wearables
3. 3

   复制后端环境变量文件

   cp ./backend/config/.env.example ./backend/config/.env
4. 4

   复制前端环境变量文件

   cp ./frontend/.env.example ./frontend/.env
5. 5

   使用 Docker Compose 启动应用

   docker compose up -d

使用前须知

• !项目处于早期阶段，1.0 版本之前 API 可能变动。
• !默认的 Docker Compose 配置面向开发环境，生产环境需使用固定版本的官方镜像。
• !需要自行托管并配置 Docker 才能运行。

收录于专题

标签

常见问题

open-wearables 是什么？

自托管平台，通过统一的标准化 API 汇聚多家可穿戴设备的健康数据，并提供 webhook 和 MCP 服务。 Open Wearables 是一个开源平台，用一套 REST API 统一接入 Garmin、Oura、Whoop、Suunto、Polar、Strava、Fitbit 以及 Apple Health 等多家可穿戴设备和运动平台的数据。开发者不必为每个厂商单独实现 OAuth 授权、数据映射和同步逻辑，所有数据都以统一的数据模型返回，涵盖活动、睡眠、训练以及心率、HRV 等时间序列。

open-wearables 可以免费使用吗？用的什么许可证？

open-wearables 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

open-wearables 还在维护吗？

活跃维护中。open-wearables 最近一次提交是在 2026年10月23日。

open-wearables 适合用来做什么？

为 AI 健康教练提供用户真实的睡眠和训练数据作为依据。 为医疗或健康类应用汇总患者或用户的穿戴设备数据。 为科研项目收集多种设备的标准化健康数据。 在自己的服务器上搭建个人穿戴数据库，并通过 MCP 客户端查询。

open-wearables 怎么安装和运行？

克隆代码仓库: git clone https://github.com/the-momentum/open-wearables.git 进入项目目录: cd open-wearables 复制后端环境变量文件: cp ./backend/config/.env.example ./backend/config/.env 复制前端环境变量文件: cp ./frontend/.env.example ./frontend/.env 使用 Docker Compose 启动应用: docker compose up -d

在哪里获取 open-wearables？

源代码和安装说明在 GitHub 上：https://github.com/the-momentum/open-wearables