mcpField
H
health4ai

health4ai

ローカル
health4.aiヘルスケア52 日前に更新
リポジトリ公式サイト

health4ai について

health4aiは、自身が所有するSupabase/Postgresプロジェクトに保存されたApple Healthデータを検索するローカルMCPサーバーです。health4ai iOSアプリからデータを取り込み、stdio対応のMCPクライアントから利用できます。

主な機能

  1. 01Apple Healthデータの検索
  2. 02自身のSupabase/Postgresへの接続
  3. 03stdioでのサーバー起動

活用シーン

  1. 01個人のApple Health記録の確認
  2. 02MCPクライアントからの健康データ検索

MCP 対応

stdioでローカルMCPサーバーを提供し、対応クライアントがSupabase/Postgres内の指定ユーザーのApple Healthデータを検索できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "jefflitt1-health4ai": {
      "command": "uvx",
      "args": [
        "health4ai"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "HEALTHKIT_USER_ID": "<HEALTHKIT_USER_ID>"
      }
    }
  }
}
起動コマンドuvx health4ai
設定が必要な環境変数
DATABASE_URLシークレットPostgres connection string for your Supabase project (transaction pooler; database password, not a service-role key).
HEALTHKIT_USER_IDUUID of the Supabase Auth user whose HealthKit data to query.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypihealth4ai0.1.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

health4ai MCP サーバー

所有する Supabase/Postgres プロジェクトからご自身のApple Health データを取得するローカル MCP サーバーです。Claude Desktop、Claude Code、Cursor、または stdio 対応の MCP クライアントで使用できます。

データは、無料の health4ai iOS アプリから送信されます。App Store からダウンロードできます。セットアップガイド：https://health4.ai/setup/

インストール

pip install health4ai

Python 3.11 以降が必要です。リポジトリをクローンしている場合は、従来の方法でも実行できます。

pip install -r mcp-server/requirements.txt
python mcp-server/main.py

設定

サーバーは stdio 経由でご自身のデータベースに接続します。次の環境変数を設定してください（または、作業ディレクトリに .env ファイルを配置してください）。

変数必須秘密情報説明
DATABASE_URLはいはいSupabase プロジェクトの Postgres 接続文字列（トランザクションプーラー用。サービスロールキーではなく、データベースのパスワードを使用してください）。SUPABASE_DB_URL も別名として使用できます。
HEALTHKIT_USER_IDはいいいえHealthKit の行を取得する対象となる Supabase Auth ユーザーの UUID です。この値が未設定、UUID ではない、または 00000000-… のプレースホルダーの場合、サーバーは起動を拒否します。
HEALTH4AI_TZいいえいいえカレンダー日単位の区分に使用する IANA タイムゾーンです（既定値は UTC）。

手順の詳細：docs/SETUP.md。

実行

pip install health4ai の実行後：

health4ai
# or
python -m health4ai

Claude Desktop／Claude Code／Cursor（mcp.json）：

{
  "mcpServers": {
    "health4ai": {
      "command": "health4ai",
      "env": {
        "DATABASE_URL": "postgresql://...",
        "HEALTHKIT_USER_ID": "<your auth user UID>"
      }
    }
  }
}

git クローンからは、"command": "python" と "args": ["/path/to/health4ai/mcp-server/main.py"] も引き続き使用できます。

ライセンス

MIT。リポジトリの LICENSE をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。