Inoffizieller Ultrahuman Ring MCP Server für die Integration von KI-Agenten

Was das ist

Ein inoffizieller Model Context Protocol (MCP)-Server, der die Ultrahuman Partner API kapselt und KI-Coding-Agents ermöglicht, direkt Gesundheitsdaten von Ultrahuman Ring- und CGM-Geräten abzufragen.

Wichtige Funktionen & Implementierung

Der Server bietet zwei Hauptwerkzeuge für KI-Agents:

• Tägliche Metriken: Liefert einen vollständigen Datendump für ein bestimmtes Datum im JSON- oder Markdown-Format.
• Live-Wert: Ruft eine einzelne Metrik (z.B. Recovery-Score, Schlaf-Score, HRV) für schnelle Statusprüfungen ab.

Verfügbare Metriken umfassen Schlafdaten, HRV, Ruheherzfrequenz, Schritte, Recovery-Scores, Glukosewerte, metabolischen Score und VO2max-Schätzungen.

Einrichtung & Voraussetzungen

Das Projekt erfordert:

• Python 3.10+
• Zugang zur Ultrahuman Partner API (Token über den "Hilfe"-Bereich der App erhalten)
• Account-E-Mail zur Authentifizierung

Anmeldedaten werden ausschließlich über Umgebungsvariablen (ULTRAHUMAN_TOKEN und ULTRAHUMAN_EMAIL) verwaltet, ohne hartkodierte Werte.

Kompatibilität & Anwendungsfälle

Der MCP-Server funktioniert mit KI-Setups, die MCP sprechen, einschließlich Claude Code, Cursor und OpenClaw. Das Repository enthält Skills, die Modellen helfen zu verstehen, wann die Werkzeuge aufgerufen werden sollen und wie Daten für Morgenbriefings, Recovery-Checks und einfache Analysen (wöchentliche Ansichten, Trends) präsentiert werden.

Ein Skript wird ebenfalls bereitgestellt, um PDF-Berichte mit Diagrammen für wöchentliche Zusammenfassungen zu generieren.

Projektdetails

• Lizenz: MIT
• Repository: https://github.com/Duzafizzl/Ultrahuman-MCP
• Status: Community-Projekt, nicht offiziell mit Ultrahuman verbunden