mi-health-mcp

Projektübersicht

mi-health-mcp macht die Freundes- und Familiendaten von 小米运动健康 (Schlaf, Herzfrequenz und Schritte) über das MCP-Protokoll für LLM-Clients wie RikkaHub zugänglich. Der Dienst läuft auf Cloudflare Workers, benötigt keinen eigenen Server und kann innerhalb des kostenlosen Cloudflare-Kontingents genutzt werden. Dieses Projekt basiert auf der Reverse-Engineering-Arbeit der Schnittstellen von Misty02600/mi-fitness-python und wurde als Cloudflare Worker + MCP-Dienst umgesetzt. Dank an das Upstream-Projekt.

Related MCP server: apple-health-shortcuts-mcp

Ein-Klick-Bereitstellung

Der Bereitstellungsprozess erfordert die Bindung eines Cloudflare KV. Wenn der Button-Prozess dazu auffordert, einen KV-Namespace zu erstellen oder auszuwählen, folge bitte der Anleitung und stelle sicher, dass die Bindung MI_HEALTH_KV heißt.

Manuelle Bereitstellung, wenn der Button nicht funktioniert

Erforderlich sind Node.js 20 oder höher sowie ein Cloudflare-Konto.

git clone https://github.com/wusaki0723/mi-health-mcp.git
cd mi-health-mcp
npm install
npx wrangler login
npx wrangler kv namespace create MI_HEALTH_KV

Trage die vom Befehl ausgegebene Namespace-ID in wrangler.toml ein und ersetze your-kv-namespace-id. Setze dann das Zugriffstoken und stelle bereit:

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

Verwende für den Wert von AUTH_TOKEN eine selbst erzeugte lange Zufallszeichenfolge und schreibe sie nicht in den Quellcode, in wrangler.toml oder in Git.

Konfiguration nach der Bereitstellung

1. KV-Namespace erstellen:

   npx wrangler kv namespace create MI_HEALTH_KV

2. Trage die vom Befehl ausgegebene Namespace-ID in [[kv_namespaces]] in wrangler.toml ein, ersetze your-kv-namespace-id, und stelle dann erneut bereit. Bei der Ein-Klick-Bereitstellung kannst du KV auch im Button-Prozess gemäß der Anleitung erstellen und binden.

3. Richte das MCP-Authentifizierungstoken interaktiv ein. Erzeuge das Token selbst als lange Zufallszeichenfolge:

   npx wrangler secret put AUTH_TOKEN

4. Stelle bei Änderungen an der Konfiguration erneut bereit:

   npx wrangler deploy

Der Name des KV-Bindings muss MI_HEALTH_KV bleiben.

Client-Konfiguration

Öffne in RikkaHub „Einstellungen > MCP > Neue Verbindung > Streamable HTTP" und fülle Folgendes aus:

• URL: https://<你的域名>/mcp

• Benutzerdefinierter Header: Authorization: Bearer <你的 token>

Dabei muss <你的 token> exakt mit dem bei der Bereitstellung gesetzten AUTH_TOKEN übereinstimmen.

Verwendungsablauf

1. Der Client ruft zuerst health_login_start auf und erhält loginUrl.

2. Rendere loginUrl mit einem beliebigen QR-Code-Tool in einen QR-Code.

3. Scanne den Code mit der 小米运动健康 App und bestätige die Anmeldung.

4. Der Client ruft wiederholt health_login_poll auf, bis success zurückgegeben wird.

5. Nach erfolgreicher Anmeldung kannst du mit health_latest, health_sleep, health_heart oder health_steps Daten abfragen.

Der Worker erzeugt keine QR-Code-Bilder. Bei Abfragen wird die Freundes- und Familienliste dynamisch gelesen und der erste Eintrag verwendet; Benutzer-IDs werden nicht fest im Code hinterlegt.

Nutzungsgrenzen

Nur zur Anmeldung mit deinem eigenen 小米-Konto und zum Abfragen der Daten von Freunden und Familie, für die du autorisiert bist. Verwende dies nicht für Zwecke, die die Privatsphäre anderer verletzen oder gegen die 小米-Nutzungsbedingungen verstoßen.

Lizenz

Dieses Projekt steht unter der GNU General Public License v3.0 (GPL-3.0) und entspricht damit der Lizenz des Upstream-Projekts Misty02600/mi-fitness-python.