huayue1024/mi-fitness-mcp-cn

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

20 stars 4 forks Quality 81 Trend 37MIT

Repository Install

小米运动健康数据本地 MCP Server + REST API + Web 仪表盘 | Local-first Mi Fitness data hub: MCP, REST API, web dashboard, QR login

Overview

小米运动健康（Mi Fitness）数据的**：MCP Server + REST API + 可视化 Web 仪表盘。把你自己账号里的健康数据同步到本地 SQLite，供 AI 客户端、其他程序或浏览器直接查询分析。 Local-first Mi Fitness (Xiaomi health) data hub: sync your own health data to a local SQLite database, exposed via MCP, REST API, and a web dashboard. - 🇨🇳 （--region cn），同时支持 ru/de/sg/us 等国际区! - 📦 ：MCP Server（AI 客户端）、REST API（任意程序）、Web 仪表盘（浏览器） - 💤 ：每日活动、逐分钟心率、睡眠分期（深睡/浅睡/REM/小睡）、运动记录、身体成分、血氧（SpO₂）、压力、异常心跳 - 🔄 ：7 天分块拉取 + 断点续传游标 + UPSERT 幂等入库，重复同步不产生脏数据 - 🔑 ：用小米凭据换取 mif_sk_* Key（类大模型平台风格），支持多账号隔离、用量统计、按前缀吊销 - 📱 ：逆向小米官方扫码流程，手机 App 扫码即可授权，告别浏览器 F12 抓 Cookie - 🖥️ （Flask）：数据图表走势、实时响应检视、cURL 一键生成、深浅主题 - 🔒 ：数据、凭据、配置全部留在本机（SQLite + 系统 keyring），不上传任何第三方服务 ⚠️ 非小米官方项目。全部云端接口为逆向所得，仅用于读取和分析**健康数据，请遵守小米用户协议。接口可能因小米改版而失效。要求 Python ≥ 3.11。Linux 无系统 keyring 时可 pip install keyrings.alt（可能明文存储凭据）。浏览器打开 http://127.0.0.1:8322/ → 点击「扫码登录」→ 用小米账号 / 米家 App 扫码确认 → 自动换取并注入 API Key。浏览器登录 account.xiaomi.

Install

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

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "mi-fitness": { "command": "mi-fitness-mcp", "args": ["serve"] }
  }
}