health4ai

本地服务

health4.ai健康医疗52 天前更新

关于 health4ai

health4ai 是本地 MCP 服务，用于查询存储在自有 Supabase/Postgres 项目中的 Apple Health 数据。数据由 health4ai iOS 应用同步，适合通过 stdio MCP 客户端访问个人健康记录。

主要功能

01查询 Apple Health 数据
02连接自有 Supabase/Postgres
03通过 stdio 提供服务

适用场景

01查看个人 Apple Health 记录
02从兼容 MCP 的客户端查询健康数据

MCP 相关

该项目通过 stdio 暴露本地 MCP 服务，让兼容的 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.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

health4ai MCP 服务

本地 MCP 服务，可从你自己的 Supabase/Postgres 项目查询你的 Apple Health 数据。可与 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 连接字符串（transaction pooler；数据库密码，而非 service_role 密钥）。也接受 `SUPABASE_DB_URL` 作为别名。
`HEALTHKIT_USER_ID`	是	否	要查询其 HealthKit 数据行的 Supabase Auth 用户 UUID。若未设置、不是 UUID，或为 `00000000-…` 占位符，服务将拒绝启动。
`HEALTH4AI_TZ`	否	否	用于按日历日分组的 IANA 时区（默认为 `UTC`）。

完整操作指南：docs/SETUP.md。

运行

安装 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"] 仍然可用。