Google Health ChatGPT Self-host

Eine inoffizielle Referenzimplementierung für den Einzelbenutzerbetrieb, die eine eng begrenzte Menge an Google-Health-Daten aus gewöhnlichen ChatGPT-Unterhaltungen über eine private MCP-Verbindung ausliest.

Dieses Repository enthält Quellcode und eine Bereitstellungsanleitung. Es veröffentlicht oder legt keine bestehenden MCP-Dienste, ChatGPT-Apps, Tunnel, Google-Cloud-Projekte, Zugangsdaten oder Gesundheitsdaten anderer offen. Jede bereitstellende Person erstellt und besitzt ein unabhängiges Google-Cloud-Projekt, einen OAuth-Grant, einen OpenAI-Tunnel, einen Host und eine ChatGPT-App im Developer Mode.

Was das Projekt bietet

• Ein Node.js-stdio-MCP-Server mit genau vier Nur-Lese-Tools.

• Vier feste Google-Health-OAuth-Scopes mit Nur-Lese-Zugriff.

• Feste Datentyp-Zulassungslisten: 32 Reconcile-Arten, 18 Rollup-Arten und IRN-Verlauf.

• Vom Server generierte Google-Filter, Validierung geschlossen–offener Intervalle, Begrenzungen der Seitengröße und datenschutzwahrende Feldmasken.

• Ein Upstream-Antwortlimit von 90.000 Byte, das bereits beim Streamen der Antwort durchgesetzt wird, bevor der vollständige Antwort-Body gepuffert wird.

• Metadaten für das Query-Routing, eingebettet in MCP-Anweisungen, Tool-Beschreibungen und Schemata, damit ChatGPT im Web die richtige Operation auswählen kann, ohne dass eine separate private Ausgangsbasis vorhanden sein muss.

• Ein lokaler Skill- und Abfragenkatalog für Entwicklung, Überprüfung und Auswertung. Der Developer Mode importiert diesen Skill nicht automatisch in ChatGPT im Web.

• Leitfäden zu Google Cloud OAuth, Linux/systemd, OpenAI Secure MCP Tunnel, ChatGPT, geplanten Tasks, Datenschutz und Fehlerbehandlung.

Related MCP server: Fitbit Air Daily Planner MCP Server

Bewusste Grenzen

Dieses Projekt ist für eine private Bereitstellung mit einem einzelnen Benutzer gedacht. Es enthält keine Schreiboperation, keinen öffentlichen MCP-Endpunkt, keine Datenbank, keinen Antwortspeicher-Cache, keine Analyse-Pipeline, keine Mehrbenutzer-Authentifizierung, kein zertifiziertes Paket für das öffentliche Plugin-Verzeichnis und keine Funktion für medizinische Diagnosen. Es ist kein eine medizinische Diagnosefunktion. Es ist kein Medizinprodukt.

Wenn ein Tool ausgeführt wird, gelangt die angeforderte Gesundheitsantwort von Google Health durch den selbst gehosteten Prozess und den Tunnel von OpenAI in die ChatGPT-Unterhaltung. Der Anwendungscode speichert diese Antwort zwar nicht dauerhaft, aber die bereitstellende Person muss die Richtlinien und das Aufbewahrungsverhalten von Google, OpenAI, der Hosting-Plattform und sämtlicher Infrastrukturprotokolle unabhängig verstehen und offenlegen.

Architektur

ChatGPT conversation or Scheduled task
                |
      private Developer Mode app
                |
       OpenAI Secure MCP Tunnel
        outbound HTTPS only
                |
          tunnel-client host
                |
         stdio Node.js MCP
                |
     Google OAuth refresh on demand
                |
       health.googleapis.com

Der Secure MCP Tunnel hält den MCP-Server vom öffentlichen Internet fern, ist aber eine private Entwicklungsverbindung und kein Weg zur Einreichung eines öffentlichen Plugins.

Nur-Lese-Vertrag

Die OAuth-Berechtigung ist an folgende Bereiche (Scopes) gebunden:

https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.irn.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly

Der MCP-Server stellt folgende Tools zur Verfügung:

Die vollständige Matrix von Datentypen zu Methoden finden Sie in skills/google-health-readonly/references/query-catalog.md.

Bereitstellungspfad

1. Lesen Sie die unter docs/architecture-and-scope.md und docs/privacy-and-security.md.

2. Konfigurieren Sie ein unabhängiges Google-Cloud-Projekt und einen OAuth-Client mit docs/google-cloud-oauth.md.

3. Holen Sie die Offline-Erteilung für den einzelnen Benutzer mit docs/local-offline-grant.md ein.

4. Erstellen und installieren Sie den MCP-Server mit docs/deploy-linux-systemd.md.

5. Erstellen und ausführen den privaten Tunnel mit docs/openai-secure-mcp-tunnel.md.

6. Fügen Sie die App im Developer Mode hinzu und weisen Sie sie mit docs/chatgpt-developer-mode.md nach.

7. Konfigurieren Sie einen geplanten Task erst nach der interaktiven Freigabe mit docs/scheduled-task.md.

Legen Sie keinerlei Zugangsdaten in diesem Repository, Chat-Nachrichten, Issues, Befehlszeilenargumente, Screenshots oder CI-Variablen mit absolut $11 million ab. Das Setup verwendet Pfadangaben in Umgebungsvariablen; die Dateien selbst dürfen nur für den Besitzer lesbar sein.

Entwicklung

Voraussetzungen: Node.js 22 oder neuer, npm und Python 3 – und nur nur, wenn Sie den optionalen Codex-Skill-Validator ausführen möchten.

npm ci
npm run check
npm run audit:discovery
npm audit

Das Discovery-Prüfung greift ausschließlich auf das öffentliche API-Discover-Dokument von Google zu; es authentifiziert sich nicht und fragt keine Gesundheitsdaten ab. Die Tests gelten mit synthetischen Testdaten.

Falls der Codex-Skill-Validator lokal installiert ist:

python3 /path/to/skill-creator/scripts/quick_validate.py skills/google-health-readonly

Sie sollten die Datei CONTRIBUTING.md Lesen, bevor Sie Änderungen einreichen. Nehmen Sie niemals echte Gesundheitsdaten, Abfrageergebnisse, Kontokennungen, OAuth-Werte, Tunnel-IDs oder Screenshots aus privaten Steuerungsumfeldern in eine Issue oder einen Pull Request aufsw ge.

Upstream-Richtlinien und Produktverfügbarkeit

Der Zugriff auf die Google-Health-API, die Verifizierung, die Offenlegungsbereiche (Scopes) und das Verhalten von Tokens unterliegt den Regeln von Google. Die Verfügbarkeit und die Berechtigungen von Developer Mode und, falls verfügbar, von Secure MCP Tunnel werden von OpenAI bestimmt und können je nach Konto oder Zugriffsbereich variieren. Prüfen Sie die verlinkte offizielle Dokumentation während der Bereitstellung immer wieder.

Lizenz

Apache License 2.0. Siehe dazu LICENSE und NOTICE.