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: Fitbit Air Daily Planner MCP Server

设计边界

本项目面向私有、单用户的使用环境。它没有写操作、没有公共 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 服务器提供：

完整的类型到方法矩阵见 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。