（7417期）Apple Health – 本地健康数据，AI 智能分析

本地健康数据，AI 智能分析 通过 MCP 将 Apple Health 导出数据接入 AI 代理，实现本地隐私安全的趋势分析与 SQL 查询，无需云端上传健康记录。 使用说明 核心用法 Apple Health 技能是一种基于 MCP（Model Context Protocol）的桥接方案，让 AI 代理能够读取并分析 Apple Health 的 CSV 导出数据。它并非直接调用 HealthKit API，而是通过处理用户从 iPhone 导出的结构化数据文件（HKQuantityTypeIdentifier.csv、HKCategoryTypeIdentifier.csv、HKWorkoutActivityType*.csv），在本地环境中执行 SQL 查询和趋势报告。 工作流程分为四个阶段：首先确认用户采用 csv-export 模式；其次验证本地导出文件夹的有效性（文件存在且非空）；接着运行运行时预检（Node.js LTS 版本、DuckDB 依赖、绝对路径配置）；最后配置 MCP 服务器并执行模式发现与日期限定的查询分析。 显著优点 隐私优先架构：健康数据完全留在本地机器，仅 npm 包安装请求和可选的 App Store 流量会离开设备，无强制云端同步。 结构化查询能力：基于 DuckDB 的 SQL 分析支持复杂趋势计算、滚动窗口对比（7天/30天/90天）和多维度健康指标关联。 明确的信任边界：清晰区分"导出数据"与"实时 API"，避免用户对数据时效性的误解。 可复现的查询日志：query-log.md 记录已知良好的 SQL 模式和输出模板，便于跨会话复用。 潜在局限 数据时效性依赖人工导出：无法获取实时或当天数据，需用户定期从 iPhone 重新导出 CSV， stale 数据可能导致过时结论。 Node.js 运行时敏感：DuckDB 原生模块对 Node 版本要求严格，非 LTS 版本（如 19、21）易引发启动失败。 第三方工具依赖：核心功能依赖 @neiltron/apple-health-mcp 包及其维护状态，若作者停更可能存在兼容性风险。 无原生 iOS 集成：无法直接读取 iCloud Health 或绕过 Apple 权限提示，导出步骤对非技术用户存在门槛。 适合人群 注重隐私、不愿将健康数据上传至第三方云服务的用户 具备基础技术能力、能够完成 iPhone 导出和本地 Node 环境配置的用户 需要定期生成健康趋势报告（如睡眠、运动、心率）进行自我量化分析的爱好者 开发者在本地构建 HealthKit 相关原型时的数据调试场景 常规风险 路径配置错误：相对路径或未验证的 HEALTHDATADIR 会导致 MCP 服务器启动成功但返回空数据，造成"假阴性"。 无界查询性能问题：在未限定日期范围的情况下扫描大型导出文件，可能导致分析缓慢和输出噪音。 过时数据误读：若未检查 memory.md 中的最后导出时间戳，可能基于陈旧数据给出"今日"建议。 供应链信任：npm 包的任何恶意更新都可能影响本地数据安全，建议锁定版本并审计依赖。 原始说明 Connect agents to Apple Health exports with MCP setup, schema validation, and privacy-safe analysis.