health4ai

io.github.jefflitt1由 GitHub 帳號 jefflitt1 發布v0.1.0更新於 Oct 24, 2026

Query your Apple Health data from your own Supabase/Postgres via local MCP.

已驗證STDIO僅桌面資料庫位置與生活

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理查詢存放在你自己 Supabase/Postgres 專案中的 Apple 健康資料。

可以做什麼
  • 透過 stdio 查詢你自己 Supabase/Postgres 資料庫中的 Apple 健康紀錄。
  • 讀取指定 Supabase Auth 使用者的 HealthKit 資料列。
  • 依可設定的時區把結果按日曆日分組。
  • 未公布工具清單，能力以 README 中查詢 HealthKit 資料的描述為準。
適用情境
當你已透過 health4ai iOS 應用程式把 Apple 健康資料同步到自己的 Supabase/Postgres 專案，並希望助理在本機回答相關問題時使用。
執行需求
需在本機安裝 Python 3.11+ 與 health4ai 套件，由桌面 MCP 用戶端以 stdio 啟動。需要 DATABASE_URL（Supabase 專案的 Postgres 連線字串，transaction pooler）與 HEALTHKIT_USER_ID（Supabase Auth 使用者 UUID）。可選 HEALTH4AI_TZ 用於按日分組。需能連線你的資料庫。
安裝前請注意
DATABASE_URL 是含資料庫密碼的機密，勿放入共用設定。伺服器會讀取資料庫中的健康資料，請只指向你自有的專案。HEALTHKIT_USER_ID 必須是真實 UUID，否則伺服器會拒絕啟動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 health4ai，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

health4ai MCP server

Local MCP server that queries your Apple Health data from a Supabase/Postgres project you own. Use it with Claude Desktop, Claude Code, Cursor, or any stdio MCP client.

The data gets there from the free health4ai iOS app: download it on the App Store. Setup guide: https://health4.ai/setup/

Install

bash
pip install health4ai

Requires Python 3.11+. From a clone of the repo you can still run the previous path:

bash
pip install -r mcp-server/requirements.txtpython mcp-server/main.py

Configure

The server talks to your database over stdio. Set these environment variables (or a .env file in the working directory):

VariableRequiredSecretDescription
DATABASE_URLyesyesPostgres connection string for your Supabase project (transaction pooler; database password, not the service_role key). SUPABASE_DB_URL is accepted as an alias.
HEALTHKIT_USER_IDyesnoUUID of the Supabase Auth user whose HealthKit rows to query. The server refuses to start if this is unset, not a UUID, or the 00000000-… placeholder.
HEALTH4AI_TZnonoIANA time zone for calendar-day buckets (default UTC).

Full walkthrough: docs/SETUP.md.

Run

After pip install health4ai:

bash
health4ai# orpython -m health4ai

Claude Desktop / Claude Code / Cursor (mcp.json):

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

From a git clone, "command": "python" and "args": ["/path/to/health4ai/mcp-server/main.py"] still work.

License

MIT. See the repository LICENSE.

來源：mcp-server/README.md，提交 da0d274

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 19, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分