Google Health ChatGPT Self-host

Неофициальная эталонная реализация для одного пользователя, предназначенная для чтения узко ограниченного набора данных Google Health из обычных диалогов ChatGPT через частное MCP-подключение.

Этот репозиторий — это исходный код и руководство по развертыванию. Он не публикует и не раскрывает чьи-либо существующие MCP-сервисы, приложения ChatGPT, туннели, проекты Google Cloud, учетные данные или данные о здоровье. Каждый разворачивающий создает и владеет независимым проектом Google Cloud, OAuth-грамотой, туннелем OpenAI, хостом и приложением ChatGPT Developer Mode.

Возможности

• Node.js stdio MCP-сервер ровно с четырьмя инструментами только для чтения.

• Четыре фиксированные OAuth-скоупа Google Health только для чтения.

• Фиксированные списки разрешенных типов данных: 32 reconcile-типа, 18 rollup-типов и история IRN.

• Генерируемые сервером фильтры Google, проверка полуоткрытых диапазонов (closed-open), лимиты размера страницы и конфиденциально сохраняющие маски полей.

• Лимит ответа вышестоящего сервиса вноний 90 000 байт, который применяется во время потоковой передачи ответа до полной буферизации тела.

• Метаданные маршрутизации запросов, встроенные в инструкции MCP, описания инструментов и схемы, чтобы веб-ChatGPT могла выбрать правильную операцию без отдельного приватного базового контекста.

• Локальный каталог Skill и запросов для разработки, рецензирования и оценки. Developer Mode не импортирует этот Skill в веб-ChatGPT автоматически.

• Руководства по Google Cloud OAuth, Linux/systemd, OpenAI Secure MCP Tunnel, ChatGPT, Scheduled task, конфиденциальности и устранению неполадок.

Related MCP server: apple-health-shortcuts-mcp

Осознанные ограничения

Этот проект предназначен для частного развертывания на одного пользователя. В нем нет операции записи, публичной MCP-конечной точки, базы данных, кэша ответов, аналитического конвейера, многопользовательской аутентификации, публичного пакета в Plugin Directory и функции постановки медицинского диагноза. Он не является медицинским устройством.

Когда выполняется инструмент, запрашиваемый ответ с данными о здоровье передается от Google Health через саморазвернутый процесс и туннель OpenAI в диалог ChatGPT. Прикладной код не сохраняет этот ответ, но развертывающий должен отдельно понять и раскрывать политики и сроки хранения Google, OpenAI, хостинг-платформы и любых инфраструктурных журналов.

Архитектура

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

OpenAI Secure MCP Tunnel позволяет держать MCP-сервер вне публичного интернета, однако это приватное это разработчик-соединение, а не путь к публичной отправке плагина.

Контракт только на чтение

OAuth-гранниц привязан к следующим областям доступа:

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

MCP-сервер предоставляет:

Полная матрица «тип-метод» находится в skills/google-health-readonly/references/query-catalog.md.

Порядок развертывания

1. Прочитайте docs/architecture-and-scope.md и docs/privacy-and-security.md.

2. Настройте независимый проект Google Cloud и OAuth-клиент в соответствии с docs/google-cloud-oauth.md.

3. Получите одноразовый офлайн-грант для одного пользователя с помощью docs/local-offline-grant.md.

4. Соберите и установите MCP-сервер с помощью docs/deploy-linux-systemd.md.

5. Создайте и запустите приватный туннель с помощью docs/openai-secure-mcp-tunnel.md.

6. Добавьте и проверьте пакет приложений Developer Mode с помощью docs/chatgpt-developer-mode.md.

7. Только после интерактивного подтверждения настройте регулярное задание с помощью docs/scheduled-task.md.

Не размещайте учетные данные в этом репозитории, сообщениях, issue-отчетах, аргументах командной строки, скриншотах или CI-переменных. Учетная запись использует пути к файлам в переменных окружения; сами файлы должны быть доступны только владельцу.

Разработка

Требования: Node.js 22 или новее, npm и Python 3, только если вы хотите запустить опциональный валидатор Codex Skill.

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

Discovery audit обращается только к публичному документу discovery API Google; он не аутентифицирует и не запрашивает данные о здоровье. Тестовый набор использует синтетические тестовые данные.

Если валидатор Codex Skill установлен локально:

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

Перед отправкой изменений ознакомьтесьс CONTRIBUTING.md. Никогда не помещайте в issue или pull request реальные данные о здоровье, результаты запросов, идентификаторы аккаунтов, значения OAuth, идентификаторы туннелей или скриншоты из приватных панелей управления.

Политика вышестоящего поставщика и доступность продукта

Доступ к Google Health API, его верификация, навигация и поведение токенов определяются Google. Доступность и разрешения Developer Mode и ChatGPT Secure MCP Tunnel определяются OpenAI и зависят от аккаунта или рабочеи пространства. Во время развертывания обязательно перепроверяйте указанные официальные документы.

Лицензия

Apache License 2.0. См. LICENSE и NOTICE.