sabatech-dev/huawei-health-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

46 stars 1 forks 품질 82 트렌드 32MIT

Repository Install

Huawei Health Kit용 MCP Server - Model Context Protocol을 통해 Huawei Watch 건강 데이터를 AI Agent에 연결하십시오

개요

Huawei Health Kit 용 최초의 오픈 소스 MCP Server는 Huawei Wearable 장치에서 건강 데이터를 읽고 분석하기 위해 AI Agent (OpenClaw, Claude Desktop 등)를 가능하게합니다. - — 심장 박동, 수면, SpO2, 스트레스, 온도, 활동, ECG 및 더 많은 - - OAuth 후 서버 측 데이터 액세스, 전화 의존성 없음 - - - 모든 MCP 호환 AI 에이전트에 플러그 - 연속 심장 박동, SpO2 모니터링 - - 귀하의 데이터, 서버, 당신의 제어 - Huawei Developer 계정 (developer.huawei.com) - 프로젝트에서 활성화 된 건강 키트 - Node.js 18 + - Python 3.11 + API는 http://localhost:8000에서 사용할 수 있습니다. - 모든 데이터는 서버에서 숙박 - OAuth 2.0 권한 흐름 - 제 3 자 데이터 저장 없음 - 각 데이터 유형에 필요한 사용자 동의 감사합니다! 이것은 새로운 프로젝트입니다. CONTRIBUTING.md 를 참조하십시오.

개요(AI 번역)

** Model Context Protocol을 통해 Huawei Watch 건강 데이터를 AI Agent에 연결 **

Huawei Health Kit 용 최초의 오픈 소스 MCP Server는 Huawei Wearable 장치에서 건강 데이터를 읽고 분석하기 위해 AI Agent (OpenClaw, Claude Desktop 등)를 가능하게합니다.

특징

** 30 + 건강 데이터 유형 ** - 심박수, 수면, SpO2, 스트레스, 온도, 활동, ECG 등
**REST API (Cloud) ** - 서버 측 데이터 액세스, OAuth 후 전화 의존성
MCP Protocol - MCP 호환 AI 에이전트에 플러그
** 실시간 가능** — 연속 심박수, SpO2 모니터링 -Privacy-first — 귀하의 데이터, 서버, 귀하의 통제

지원 자료

| 분류 | 미터 | |—||| | Cardiovascular | 심박수(간격, 연속, 휴식, 운동), ECG, arrhythmia alert | |Sleep | 단계(깊은, 빛, REM), 낮잠, apnea 감지, 품질 점수 | |Oxygenation | 연속 SpO2, 수면 SpO2 | |Stress | 스트레스 수준, 동향, 호흡 운동 | | Temperature | 피부 온도 (일 + 밤) | |액티비티 | 단계, 거리, 칼로리, 액티비티링, 100+ 운동 모드 | |여성 건강 | 기간, ovulation, fertile window |

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

🏥 Huawei Health MCP Server

Connect your Huawei Watch health data to AI agents via Model Context Protocol

The first open-source MCP Server for Huawei Health Kit, enabling AI agents (OpenClaw, Claude Desktop, etc.) to read and analyze health data from any Huawei wearable device.

🎯 Features

30+ health data types — Heart rate, sleep, SpO2, stress, temperature, activity, ECG, and more
REST API (Cloud) — Server-side data access, no phone dependency after OAuth
MCP Protocol — Plug into any MCP-compatible AI agent
Real-time capable — Continuous heart rate, SpO2 monitoring
Privacy-first — Your data, your server, your control

📊 Supported Data

Category	Metrics
Cardiovascular	Heart rate (instant, continuous, resting, exercise), ECG, arrhythmia alerts
Sleep	Phases (deep, light, REM), naps, apnea detection, quality score
Oxygenation	Continuous SpO2, sleep SpO2
Stress	Stress level, trends, breathing exercises
Temperature	Skin temperature (day + night)
Activity	Steps, distance, calories, Activity Rings, 100+ workout modes
Women’s Health	Period, ovulation, fertile window
Emotional	Mood state, emotional wellbeing (TruSense)
Advanced Sports	Golf, free diving, trail running, cycling power, running form

🏗️ Architecture

Huawei Watch GT 5 Pro
        ↓
Huawei Health (Android)
        ↓
Huawei Health Kit REST API (Cloud)
        ↓
┌─────────────────────┐
│   Backend API       │  ← OAuth, data sync, storage
│   (FastAPI)         │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   MCP Server        │  ← Tools for AI agents
│   (TypeScript)      │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   AI Agents         │  ← OpenClaw, Claude Desktop, etc.
│   (OpenClaw/LLM)    │
└─────────────────────┘

📁 Project Structure

huawei-health-mcp/
├── android-app/          # Android OAuth bridge (minimal)
│   └── app/              # Kotlin app for Health Kit authorization
├── mcp-server/           # MCP Server (TypeScript/Node.js)
│   └── src/              # Tools, types, client
├── api/                  # Backend API (Python/FastAPI)
│   └── src/              # OAuth, data sync, endpoints
├── docs/                 # Documentation
│   ├── setup.md          # Setup guide
│   └── api-reference.md  # MCP tools reference
└── .github/workflows/    # CI/CD

🚀 Quick Start

Prerequisites

Huawei Developer account (developer.huawei.com)
Health Kit enabled for your project
Node.js 18+
Python 3.11+

Backend API Setup

Clone and setup:

git clone https://github.com/sabatech-dev/huawei-health-mcp.git
cd huawei-health-mcp

Configure environment variables:

cd api
cp .env.example .env
# Edit .env with your Huawei OAuth credentials

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "huawei-health": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": { "API_URL": "http://localhost:8081" }
    }
  }
}