Zepp Life data的MCP服务器.

此工程为 Zepp Life 从导出文件或 Zepp 云会话流中提供本地缓存、同步和 MCP 工具 。

□ 支持来源

• [[T0]用于当地Zepp出口
• [[T1],用于[T2]基于云的存取

□ 当前数据覆盖

目前的执行工作支持:

• 每日步道、距离和活热量
• 睡会,有光,深,REM,醒了时间,醒来数
• 被动和休息心率([[T3])
• 为已知的Zepp运动代号使用可读体育名称进行锻炼
• 重量和身体结构测量

云的覆盖率可因账户、区域和上游终点稳定性而异。 当您需要可预测的全史访问时, 导出模式是最安全的选项 。

云连接懒:服务器启动并tools/list不等Zepp登录. 第一个数据工具建立了一个共享连接。 如果省略 user_id,适配器试图从带状汇总数据的最后30天中发现数值UID并存储在系统密钥环中.

□ 安装

□ 设置

\ 云会

你需要一个[T6]。

典型流量 :

1. 开放`[T7]

Zepp Life MCP

MCP server for Zepp Life data.

This project provides local caching, sync, and MCP tools for Zepp Life data from either exported files or the Zepp cloud session flow.

Supported sources

• export_file for local Zepp exports
• cloud_session for apptoken-based cloud access

Current data coverage

The current implementation supports:

• daily steps, distance, and active calories
• sleep sessions with light, deep, REM, awake time, and wake count
• passive and resting heart rate (slp.rhr)
• workouts with readable sport names for known Zepp sport codes
• weight and body-composition measurements

Cloud coverage can vary by account, region, and upstream endpoint stability. Export mode is the safest option when you need predictable full-history access.

Cloud connections are lazy: server startup and tools/list do not wait for Zepp login. The first data tool establishes one shared connection. If user_id is omitted, the adapter attempts to discover the numeric UID from the last 30 days of band summary data and stores it in the system keyring.

Install

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

Setup

Cloud session

You need an apptoken.

Typical flow:

1. Open https://user.huami.com/privacy2/index.html
2. Sign in to the Zepp Life account
3. Open browser DevTools
4. Find the apptoken cookie

Then configure the server:

zepp-life-mcp setup --mode cloud_session --token "" --region eu
zepp-life-mcp doctor

--user-id remains supported and can be supplied explicitly if automatic discovery is unavailable.

Export file mode

zepp-life-mcp setup --mode export_file --export-path ~/Downloads/ZeppExport
zepp-life-mcp doctor

Use

zepp-life-mcp sync --start-date 2022-01-01 --end-date 2022-12-31
zepp-life-mcp serve

MCP client config

Example Claude Desktop config:

{
  "mcpServers": {
    "zepp-life": {
      "command": "zepp-life-mcp",
      "args": ["serve"]
    }
  }
}

MCP tools

All tool responses keep the backward-compatible JSON envelope with status: "ok" or status: "error". Failed calls also use MCP isError: true.