Google Health ChatGPT Self-host

Una implementación de referencia no oficial y de un solo usuario para leer un conjunto de datos de Google Health estrictamente delimitado a partir de conversaciones normales de ChatGPT mediante una conexión MCP privada.

Este repositorio contiene el código fuente y una guía de despliegue. No publica ni expone el servicio MCP, la aplicación de ChatGPT, el túnel, el proyecto de Google Cloud, las credenciales ni los datos de salud de ninguna persona. Cada persona que realiza el despliegue crea y posee un proyecto de Google Cloud, una concesión de OAuth, un túnel de OpenAI, un host y una aplicación de ChatGPT Developer Mode independientes.

Qué proporciona

• Un servidor MCP stdio de Node.js con exactamente cuatro herramientas de solo lectura.

• Cuatro ámbitos de OAuth de solo lectura de Google Health, fijos.

• Listas de tipos de datos permitidos fijas: 32 tipos de reconcile, 18 tipos de rollup y el historial de IRN.

• Filtros de Google generados por el servidor, validación de rangos cerrado-abierto, límites de tamaño de página y máscaras de campos que preservan la privacidad.

• Un límite de 90 000 bytes para las respuestas que llegan del proveedor, aplicado mientras la respuesta se transmite en streaming y antes de que el cuerpo completo se almacene en búfer.

• Metadatos de enrutamiento de consultas integrados en las instrucciones de MCP, las descripciones de las herramientas y los esquemas, de modo que ChatGPT web pueda elegir la operación correcta sin necesidad de una base de referencia privada separada.

• Un Skill local y un catálogo de consultas para el desarrollo, la revisión y la evaluación. Developer Mode no importa automáticamente este Skill a ChatGPT web.

• Guías de OAuth de Google Cloud, Linux/systemd, OpenAI Secure MCP Tunnel, ChatGPT, tareas programadas, privacidad y solución de problemas.

Related MCP server: Fitbit Air Daily Planner MCP Server

Límites deliberados

Este proyecto está pensado para un despliegue privado y de un solo usuario. No tiene ninguna operación de escritura, ni endpoint MCP público, ni base de datos, ni caché de respuestas, ni canal de analítica, ni autenticación para múltiples usuarios, ni paquete público de Plugin Directory, ni función de diagnóstico médico. No es un dispositivo médico.

Cuando se ejecuta una herramienta, la respuesta de salud solicitada viaja desde Google Health a través del proceso autohospedado y del túnel de OpenAI hasta la conversación de ChatGPT. El código de la aplicación no persiste esa respuesta, pero la persona que despliega debe comprender y divulgar por separado las políticas y el comportamiento de retención de Google, OpenAI, la plataforma de alojamiento y los registros de infraestructura.

Arquitectura

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

Secure MCP Tunnel mantiene el servidor MCP fuera de la internet pública, pero es una conexión de desarrollo privada y no es una vía para el envío público de plugins.

Contrato de solo lectura

La concesión de OAuth está fijada a estos ámbitos:

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

El servidor MCP expone:

La matriz completa de tipos y métodos está en skills/google-health-readonly/references/query-catalog.md.

Ruta de despliegue

1. Lea docs/architecture-and-scope.md y docs/privacy-and-security.md.

2. Configure un proyecto de Google Cloud y un cliente Google Cloud OAuth independientes con docs/google-cloud-oauth.md.

3. Obtenga la concesión de OAuth sin conexión para un solo usuario con docs/local-offline-grant.md.

4. Instale el servidor MCP con docs/deploy-linux-systemd.md.

5. Cree y ejecute el túnel privado con docs/openai-secure-mcp-tunnel.md.

6. Añada y valide la aplicación de ChatGPT Developer Mode con docs/chatgpt-developer-mode.md.

7. Solo después de la aceptación interactiva, configure una tarea programada con docs/scheduled-task.md.

No coloque credenciales en este repositorio, en mensajes de chat, en incidencias, en argumentos de línea de comandos, en capturas de pantalla ni en variables de CI. La instalación usa rutas de archivo en variables de entorno; los archivos mismos deben ser accesibles solo por su propietario.

Desarrollo

Requisitos: Node.js 22 o una versión más reciente, npm y Python 3 solo si se desea ejecutar el validador opcional de Codex Skill.

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

La auditoría de descubrimiento solo contacta con el documento público de descubrimiento de la API de Google; no se autentica ni consulta datos de salud. El conjunto de pruebas utiliza datos sintéticos.

Si el validador de Codex Skill está instalado localmente:

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

Consulte CONTRIBUTING.md antes principal de enviar cambios. No incluya nunca datos de salud reales, resultados de consultas, identificadores de cuentas, valores de OAuth, IDs de túnel ni capturas de planos de control privados en un issue ni en una pull request.

Política del proveedor y disponibilidad del producto

El acceso a la API de Google Health, su verificación, los scopes y el comportamiento de los tokens se rigen por Google. La disponibilidad y los permisos de Developer Mode y de Secure MCP Tunnel proceden tienen un control de OpenAI y pueden variar según elaccount o el workspace. Vuelva a consultar siempre la documentación oficial vinculada durante el despliegue.

Licencia

Apache License 2.0. Consulte LICENSE y NOTICE.