mi-health-mcp

Projektbeschreibung

mi-health-mcp stellt die Freundes- und Familiendaten von 小米运动健康 – einschließlich Schlaf, Herzfrequenz und Schritten – über das MCP-Protokoll LLM-Clients wie RikkaHub bereit. Der Dienst läuft auf Cloudflare Workers, benötigt keinen eigenen Server und kann im kostenlosen Kontingent von Cloudflare genutzt werden. Dieses Projekt wurde auf Basis der Reverse-Engineering-Ergebnisse der Schnittstelle von Misty02600/mi-fitness-python in einen Cloudflare Worker + MCP-Dienst umgeschrieben. Dank an das Upstream-Projekt.

Related MCP server: Health Vault

Ein-Klick-Bereitstellung

Der Bereitstellungsprozess erfordert die Bindung an Cloudflare KV. Wenn der Button-Prozess zum Erstellen oder Auswählen eines KV-Namespace auffordert, folgen Sie den Anweisungen und stellen Sie sicher, dass die Bindung MI_HEALTH_KV heißt.

Manuelle Bereitstellung, falls 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

Fügen Sie die vom Befehl ausgegebene Namespace-ID in wrangler.toml ein und ersetzen Sie your-kv-namespace-id. Legen Sie dann ein Zugriffstoken fest und stellen Sie bereit:

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

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

Konfiguration nach der Bereitstellung

1. Erstellen Sie einen KV-Namespace:

   npx wrangler kv namespace create MI_HEALTH_KV

2. Fügen Sie die vom Befehl ausgegebene Namespace-ID in [[kv_namespaces]] in wrangler.toml ein, ersetzen Sie your-kv-namespace-id und stellen Sie erneut bereit. Bei der Ein-Klick-Bereitstellung können Sie den KV auch im Button-Prozess anlegen und binden.

3. Legen Sie das MCP-Authentifizierungstoken interaktiv fest. Erzeugen Sie das Token selbst als lange Zufallszeichenfolge:

   npx wrangler secret put AUTH_TOKEN

4. Stellen Sie bei Konfigurationsänderungen erneut bereit:

   npx wrangler deploy

Der Name des KV-Bindings muss MI_HEALTH_KV bleiben.

Client-Konfiguration

Öffnen Sie in RikkaHub „Einstellungen > MCP > Neue Verbindung > Streamable HTTP“ und füllen Sie Folgendes aus:

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

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

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

Verwendung

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

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

3. Scannen Sie den Code mit der 小米运动健康-App und bestätigen Sie die Anmeldung.

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

5. Nach erfolgreicher Anmeldung fragen Sie Daten mit health_latest, health_sleep, health_heart oder health_steps ab.

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

Nutzungsgrenzen

Nur zur Anmeldung mit deinem eigenen 小米-Konto und zum Abrufen der von dir autorisierten Freundes- und Familiendaten. Bitte nicht für Zwecke verwenden, 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.