🏥 华为健康MCP服务器
通过模型上下文协议将您的华为手表健康数据连接到AI代理
第一个开源MCP服务器 华为健康套件，使AI代理（OpenClaw、Claude Desktop等）能够读取和分析来自任何华为可穿戴设备的健康数据。
🎯 特性
- 30+健康数据类型 --心率、睡眠、SpO2、压力、体温、活动、心电图等
- REST API（云） --服务器端数据访问，OAuth后无电话依赖
- MCP协议 --插入任何与MCP兼容的AI代理
- 实时能力 --连续心率、SpO2监测
- 隐私第一 --你的数据、你的服务器、你的控制
📊 支持的数据
| 类别 | 指标 |
|---|---|
| 心血管 | 心率（即时、连续、休息、运动）、心电图、心律失常警报 |
| 睡眠 | 阶段（深、浅、REM）、小睡、呼吸暂停检测、质量评分 |
| 氧合作用 | 持续SpO2、睡眠SpO2 |
| 压力 | 压力水平、趋势、呼吸练习 |
| 温度 | 皮肤温度（白天+夜间） |
| 活动 | 步数、距离、卡路里、活动环、100多种锻炼模式 |
| 女性健康 | 经期、排卵期、生育期 |
| 情感的 | 情绪状态、情绪健康（TruSense） |
| 高级体育 | 高尔夫、自由潜水、越野跑、自行车力量、跑步形式 |
🏗️ 建筑
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) │
└─────────────────────┘📁 项目结构
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🚀 快速开始
先决条件
- 华为开发者账号(developer.huawei.com)
- 为您的项目启用了Health Kit
- Node.js 18+
- Python 3.11+
后端API设置
- 克隆和设置：
git clone https://github.com/llllJokerllll/huawei-health-mcp.git
cd huawei-health-mcp- 配置环境变量：
cd api
cp .env.example .env
# Edit .env with your Huawei OAuth credentials- 安装依赖项并运行：
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn src.main:app --reloadAPI将于 http://localhost:8000
Docker部署
# From project root
docker-compose up -dMCP服务器设置
cd mcp-server
npm install
npm run buildMCP工具
| 工具 | 说明 |
|---|---|
get_heart_rate | 获取当前和历史心率数据 |
get_sleep_data | 获取睡眠分析（阶段、质量、持续时间） |
get_spo2 | 获取血氧饱和度 |
get_steps | 获取每日步数和距离 |
get_stress | 了解压力水平和趋势 |
get_temperature | 获取皮肤温度读数 |
get_health_summary | 获取全面的每日/每周健康摘要 |
get_workout_history | 获取运动和锻炼数据 |
get_ecg | 获取心电图分析结果 |
🔐 安全
- 所有数据保持不变 你的 服务器
- OAuth 2.0授权流程
- 无第三方数据存储
- 每种数据类型都需要用户同意
📋 许可证
Apache-2.0——免费开源。
🤝 贡献
欢迎投稿！这是一个新项目。看 贡献.md 作为指导方针。
🙏 学分
______________________________________________________________________
✅ 当前状态
- ✅ 后端API（FastAPI） -在所有端点上完全实现
- ✅ MCP服务器（TypeScript） -所有9个工具均已定义，编译成功
- ✅ Docker支持 -准备部署
- ✅ 测试套件 -模拟华为API 80%通过率
- ⏳ 华为开发者验证 -挂起（还不能测试真正的API）
- ⏳ 安卓OAuth桥 -即将推出
注： 在等待华为开发者帐户验证的同时，完整的基础设施已经准备就绪。验证后，只需将凭据添加到 .env 该系统将与真正的华为健康工具包API配合使用。
华为开发者项目： 我的健康观察（ID:101653523863750125）