AI导哈

Apple健康数据服务器

一个用于读取和查询Apple健康数据的MCP服务器，支持从本地CSV文件中获取步数、心率、睡眠等健康指标和锻炼数据。

  • by daveremy
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 daveremy/apple-health-mcp

使用说明

苹果健康mcp

用于Apple Health数据的MCP服务器。读取由导出的每日健康指标和锻炼 健康汽车出口 iOS应用程序。

特性

  • MCP服务器：3个工具，用于从Claude Code或任何MCP客户端查询Apple Health数据
  • 不需要API密钥：读取由健康自动导出导出到iCloud Drive的本地CSV文件
  • 全面的：步数、心率、心率变异性、血氧饱和度、睡眠阶段、身体成分、锻炼

MCP工具

工具 说明
apple_health_daily 每日总结：步数、能量、心率、心率变异性、睡眠阶段、身体机能、锻炼
apple_health_workouts 日期的锻炼课程（类型、持续时间、心率、卡路里、距离）
apple_health_trends 步数、心率、心率变异性、睡眠、体重的多日趋势

设置

1.在iPhone上设置健康自动导出

此MCP服务器读取由生成的CSV文件 健康汽车出口，一款自动将Apple Health数据导出到iCloud Drive的第三方iOS应用程序。该应用程序在后台运行，全天同步新数据。

  1. 安装 健康汽车出口 来自App Store
  2. 打开应用程序，并在收到提示时授予其访问Apple Health数据的权限
  3. 首选 自动化 并创建两个自动化：
    • 每日指标：选择您想要的健康指标（步数、心率、睡眠等），将格式设置为 CSV文件，频率 每日，以及目的地 iCloud云端硬盘
    • 锻炼：选择锻炼数据，将格式设置为 CSV文件，频率 每日，以及目的地 iCloud云端硬盘
  4. 该应用程序将CSV文件导出到iCloud Drive，iCloud Drive会自动同步到您的Mac：
    ~/Library/Mobile Documents/iCloud~com~ifunography~HealthExport/Documents/
  5. 通过检查目录是否包含以下内容来验证文件是否正在同步 Daily Export/ 和 Workouts/ 带有过时CSV文件的文件夹

2.安装

git clone https://github.com/daveremy/apple-health-mcp.git
cd apple-health-mcp
npm install
npm run build

3.用作MCP服务器

添加到您的Claude Code项目 .mcp.json:

{
  "mcpServers": {
    "apple-health": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/apple-health-mcp/dist/mcp.js"]
    }
  }
}

或者在Claude CLI中注册：

claude mcp add apple-health --scope project -- node /path/to/apple-health-mcp/dist/mcp.js

自定义导出目录

如果“健康自动导出”保存到其他位置，请设置环境变量：

{
  "env": {
    "APPLE_HEALTH_EXPORT_DIR": "/path/to/your/export/directory"
  }
}

数据格式

服务器需要健康自动导出生成的CSV文件结构：

Documents/
  Daily Export/
    HealthMetrics-YYYY-MM-DD.csv
  Workouts/
    Workouts-YYYY-MM-DD.csv

需求

许可证

麻省理工学院

相关 MCP