Zepp Life 데이터를 위한 MCP 서버.

이 프로젝트는 Zepp Life 데이터의 로컬 캐싱, 동기화 및 MCP 도구를 제공합니다.

지원 소스

• export_file 지역 Zepp 수출
• cloud_session apptoken] 기반 클라우드 액세스

현재 자료 적용

현재 구현 지원:

• 일일 단계, 거리 및 활성 칼로리
• 빛, 깊은, REM, awake 시간, 깨진 카운트와 수면 세션
• 수동 및 휴식 심박수 (slp.rhr)
• 알려진 Zepp 스포츠 코드에 대한 읽기 쉬운 스포츠 이름과 운동
• 무게와 몸 위치 측정

Cloud 적용은 계정, 지역 및 업스트림 엔드포인트 안정성에 따라 다를 수 있습니다. 수출 형태는 예측할 수 있을 때 가장 안전한 선택권입니다.

Cloud 연결은 게으른: 서버 시작 및 tools/list는 Zepp 로그인을 기다리지 않습니다. 첫 번째 데이터 도구는 하나의 공유 연결을 설정합니다. user_id가 omitted 인 경우, 어댑터는 밴드 요약 데이터의 마지막 30 일에서 숫자 UID를 발견하고 시스템 키링에 저장합니다.

설치

설치

클라우드 세션

apptoken가 필요합니다.

전형적인 교류:

1. https://user.huami.com/privacy2/index.을 여십시오

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.