Google Health ChatGPT Self-host

Google Healthのうち厳しく限定されたデータ群を、プライベートなMCP接続を通じて通常のChatGPTとの会話から読み取るための、非公式の単一ユーザー向けリファレンス実装です。

このリポジトリは、ソースコードとデプロイガイドです。既存のMCPサービス、ChatGPTアプリ、トンネル、Google Cloudプロジェクト、認証情報、健康データを公開・外部にさらすものではありません。デプロイする各人は、独立したGoogle Cloudプロジェクト、OAuth認可、OpenAIトンネル、ホスト、ChatGPT Developer Modeアプリを作成して所有します。

提供内容

• 読み取り専用ツールをちょうど4つ備えた、Node.jsのstdio MCPサーバー。

• Google Healthの読み取り専用OAuthスコープ4つに固定。

• データ型の許可リストを固定: reconcileタイプ32種、rollupタイプ18種、IRN履歴。

• サーバー生成のGoogleフィルター、半開区間（closed-open）の範囲検証、ページサイズ上限、プライバシーを保護するフィールドマスク。

• レスポンスのストリーミング中、全体をバッファリングする前に強制される、90,000バイトの上流レスポンス上限。

• クエリルーティング用メタデータをMCPインストラクション、ツール説明、スキーマに埋め込み、web ChatGPTだけで、別途プライベートベースラインを用意しなくても正しい操作を選択できるようにする。

• 開発・レビュー・評価のためのローカルなSkillとクエリカタログ。Developer ModeはこのSkillをweb ChatGPTに自動インポートしません。

• Google Cloud OAuth、Linux/systemd、OpenAI Secure MCP Tunnel、ChatGPT、Scheduled task、プライバシー、トラブルシューティングの各ガイド。

Related MCP server: Fitbit Air Daily Planner MCP Server

意図的な境界

このプロジェクトは、プライベートな単一ユーザーによるデプロイを想定しています。書き込み操作、公開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

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クライアントを設定する。

3. docs/local-offline-grant.md に従い、単一ユーザー向けオフライン認可を取得する。

4. docs/deploy-linux-systemd.md に従い、MCPサーバーをビルドしインストールする。

5. docs/openai-secure-mcp-tunnel.md に従い、プライベートトンネルを作成して実行する。

6. docs/chatgpt-developer-mode.md に従い、Developer Modeアプリを作成して検証する。

7. 対話的に受諾を確認した後にだけ、docs/scheduled-task.md に従って定期タスクを構成する。

認証情報をこのリポジトリ、チャットのメッセージ、イシューレポート、コマンドライン引数、スクリーンショット、CI変数内に置かないでください。セットアップでは環境変数にファイルパスを示し、そのファイル自体は所有者のみアクセスできる権限にします。

開発

要件: Node.js 22以降。npm。オプションのCodexスキルバリデータを実行する場合のみPython 3が必要です。

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

ディスカバリテストはGoogleの公開APIディスカバリドキュメントにのみ接触し、認証や健康データへのクエリは行いません。テストスイートは合成フィクスチャを使用します。

Codexスキルバリデータをローカルにインストールしている場合:

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

変更を送信する前に、必ず CONTRIBUTING.md を参照してください。実際の健康データ、クエリ結果、アカウント識別子、OAuthの値、トンネルID、個人管理画面のスクリーンショットを、機能・プルリクエストには決して含めないでください。

上流ポリシーと製品の利用可否

Google Health APIへのアクセス、検証、スコープ、トークンの挙動はGoogleが管理します。Developer Modeアプリ版やSecure MCP Tunnelの利用可否・権限は、お客様のアカウントや Organizationworkspaceによって異なる場合があります。デプロイ中は常に必ず、リンクされた公式ドキュメントを再確認してください。

ライセンス

Apache License 2.0です。LICENSE と NOTICE を参照してください。