Skip to main content
Glama
google-health-chatgpt-selfhost

google-health-chatgpt-selfhost

by paceaitian

Google Health ChatGPT Self-host

一个非官方、单用户的参考实现,用于通过私有 MCP 连接从普通 ChatGPT 对话中读取一组范围有限的 Google Health 数据。

本仓库包含源代码和一份部署指南。它不发布或暴露任何人的现有 MCP 服务、ChatGPT 应用、隧道、Google Cloud 项目、用户凭据或健康数据。每个部署者都会独立创建并拥有自己的 Google Cloud 项目、OAuth 授权、OpenAI 隧道、主机和 ChatGPT Developer Mode 应用。

它提供的内容

  • 一个 Node.js stdio MCP 服务器,正好提供四个只读工具。

  • 四个固定的 Google Health 只读 OAuth 范围。

  • 对数据类型也有固定的允许列表:32 种 reconcile 类型、18 种 rollup 类型,以及 IRN 历史。

  • 服务器在用户自身一侧生成的 Google 过滤器、左闭右开区间校验、分页大小限制,以及保护隐私的字段掩码。

  • 对上游 90,000 字节响应设置的在线限制;在完整响应体尚未缓冲完毕、数据仍在流式传输时便强制执行。

  • 将查询路由元数据嵌入到 MCP 指令、工具描述和 schema 中,使 web ChatGPT 在无独立私有基线的情况下也能选择正确的操作。

  • 一套用于开发、复查和评估的本地 Skill 与查询目录。Developer Mode 不会自动将这个 Skill 导入 web ChatGPT。

  • Google Cloud OAuth、Linux/systemd、OpenAI Secure MCP Tunnel、ChatGPT、计划任务、隐私和故障排查方面的部署指南。

Related MCP server: fitbridge

设计边界

本项目面向私有、单用户的使用环境。它没有写操作、没有公共 MCP 端点、没有数据库、没有响应缓存、没有分析管道、没有多用户认证、没有公共插件目录包,也不提供任何医疗诊断功能。它不是医疗设备。

当某个工具运行时,所需的健康响应从 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

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 服务器提供:

Tool

Intended result

google_health_daily_rollup

日历日总计和逐日趋势

google_health_physical_rollup

5 分钟、15 分钟、1 小时、6 小时或 24 小时分段

google_health_reconcile

按日、样本、区间、睡眠 session 或运动 session 的记录

google_health_irn_list

心律不齐通知记录

完整的类型到方法矩阵见 skills/google-health-readonly/references/query-catalog.md。

部署路径

  1. 阅读 docs/architecture-and-scope.md 和 docs/privacy-and-security.md。

  2. 用 docs/google-cloud-oauth.md 配置一个独立的 Google Cloud 项目和 OAuth client。

  3. 用 docs/local-offline-grant.md 获取单用户离线授权。

  4. 用 docs/deploy-linux-systemd.md 构建并安装 MCP server。

  5. 用 docs/openai-secure-mcp-tunnel.md 创建并运行私有隧道。

  6. 用 docs/chatgpt-developer-mode.md 添加并验证 Developer Mode 应用。

  7. 只有在通过交互式验收之后,才可用 docs/scheduled-task.md 配置定时任务。

不要将凭据放到本仓库、聊天消息、问题报告、命令行参数、截图或 CI 变量中。本仓库中的配置通过环境变量指定文件路径;这些文件本身必须只能由所属用户访问(owner-only)。

开发

要求:Node.js 22 或更新版本、npm;如果打算运行可选的 Codex Skill validator,才需要 Python 3。

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

文明审计只接触 Google 的公开 API discovery 文档,不执行认证,也不查询健康数据。测试套件使用的是合成的 fixtures。

如果已经在本地安装 Codex Skill validator:

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

提交改动前请阅读 CONTRIBUTING.md。不要在 issue 或 pull request 中包含真实的健康数据、查询结果、账户标识符、OAuth 值、隧道 ID,以及来自私有控制台的截图。

上游策略与产品可用性

Google Health API 的访问权限、验证方式、数据范围和令牌行为,都由 Google 决定。Developer Mode 和 OpenAI Secure MCP Tunnel 的可用性与权限由 OpenAI 决定,并可能因账号或工作区而异。部署时,请以所链接的官方最新文档为准。

许可证

Apache License 2.0。参见:LICENSE 和 NOTICE。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Exposes Apple Health data as three read-only MCP tools (current status, details, trends) via a Cloudflare Worker, enabling AI assistants to view health metrics without modification.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT and Claude to access Android Health Connect records through nine read-only MCP tools for overviews, daily summaries, sleep, workouts, intraday series, trends, correlation, search, and fetch.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT and other MCP clients to securely read Health Connect-derived health and training history, retrieve daily readiness and workout briefs, save schema-validated coach reports, and trigger email delivery through OAuth-protected tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI apps to query a user's Google Health data—such as sleep, heart rate, HRV, activity, and paired devices—through read-only tools deployed privately in the user's own Firebase project.
      1
      AGPL 3.0