苹果健康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应用程序。该应用程序在后台运行,全天同步新数据。
- 安装 健康汽车出口 来自App Store
- 打开应用程序,并在收到提示时授予其访问Apple Health数据的权限
- 首选 自动化 并创建两个自动化:
- 每日指标:选择您想要的健康指标(步数、心率、睡眠等),将格式设置为 CSV文件,频率 每日,以及目的地 iCloud云端硬盘 - 锻炼:选择锻炼数据,将格式设置为 CSV文件,频率 每日,以及目的地 iCloud云端硬盘
- 该应用程序将CSV文件导出到iCloud Drive,iCloud Drive会自动同步到您的Mac:
~/Library/Mobile Documents/iCloud~com~ifunography~HealthExport/Documents/- 通过检查目录是否包含以下内容来验证文件是否正在同步
Daily Export/和Workouts/带有过时CSV文件的文件夹
2.安装
git clone https://github.com/daveremy/apple-health-mcp.git
cd apple-health-mcp
npm install
npm run build3.用作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需求
- Node.js 18+
- macOS(用于iCloud Drive访问)
- 健康汽车出口 iOS应用程序
许可证
麻省理工学院
