Apple Health MCP

Apple Health MCP 是一个专为 Apple 健康数据设计的 MCP 服务器，基于 DuckDB 实现高效的数据查询和分析。用户可以通过自然语言或 SQL 查询方式访问健康数据，并自动生成周报或月报，适用于需要深入分析健康趋势的用户。

核心功能

Apple Health MCP 提供了多种核心功能，帮助用户高效管理健康数据：

• 自然语言查询：用户可以直接通过自然语言提问，如“显示我过去30天的心率数据”，系统会自动将其转化为数据库查询。
• SQL 查询：支持直接使用 SQL 查询健康数据，适合熟悉数据库操作的用户。
• 自动报告生成：可自动生成周报或月报，汇总用户的健康数据，便于长期趋势分析。
• 智能缓存：查询结果会进行缓存，提高重复查询的效率。
• 高效数据加载：支持懒加载和可配置的时间窗口，优化大数据处理。

安装方法

Apple Health MCP 无需传统安装，可通过 npx 直接调用。用户只需在 Claude Desktop 或其他 MCP 客户端中配置相关设置即可。

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/health/export"
      }
    }
  }
}

在配置中，HEALTH_DATA_DIR 是必需的环境变量，指向 Apple Health 数据的导出目录。

使用方法

使用 Apple Health MCP 需要先导出 Apple Health 数据，并通过配置文件连接到 MCP 服务器。

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/Users/yourname/Downloads/HealthAll_2025-07-202_01-04-39_SimpleHealthExportCSV",
        "MAX_MEMORY_MB": "2048"
      }
    }
  }
}

配置完成后，用户可以通过以下命令进行操作：

• health_schema：查看可用的数据表和结构。
• health_query：执行 SQL 查询。
• health_report：生成健康报告。

使用示例

以下是几个典型的使用场景和示例：

• 查询心率趋势：用户可以输入“显示我过去30天的心率数据”，系统将返回包含日期和心率值的图表。
• 生成运动报告：用户可以输入“生成我上周的运动报告”，系统将返回包含运动类型、时长和卡路里消耗的汇总报告。
• 睡眠分析：用户可以输入“比较我这周和上周的睡眠时间”，系统将返回睡眠时间对比图表和分析。

数据结构

Apple Health 数据需以 CSV 文件形式导出，文件名需遵循以下模式：

• HKQuantityTypeIdentifier*.csv：定量健康指标。
• HKCategoryTypeIdentifier*.csv：分类健康数据。
• HKWorkoutActivityType*.csv：锻炼和活动数据。

每个 CSV 文件应包含以下列：

• type：具体的健康指标类型。
• sourceName：源设备/应用。
• startDate：开始时间戳（UTC）。
• endDate：结束时间戳（UTC）。
• value：测量值。
• unit：测量单位。

注意事项

在使用 Apple Health MCP 时，需要注意以下几点：

• 数据处理完全在本地进行，不会上传到云端。
• 初始加载大量数据时可能需要较多内存，可通过设置 MAX_MEMORY_MB 调整。
• 查询速度慢时，可尝试缩小时间范围或优化查询语句。

Apple Health MCP 为用户提供了一种高效、灵活的方式来管理和分析 Apple 健康数据，无论是日常健康监测还是长期趋势分析，都能提供有力支持。