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 分