SuperAPI AI 工具集

apple-health-mcp-server

智能体与模型

查看项目

更新于 10-16 00:20

技能介绍

用途:Apple Health MCP Server 是一个基于 FastMCP 构建的 Model Context Protocol 服务器,用于以自然语言查询 Apple Health 数据。它解析 Apple Health XML 导出文件,并加载到 DuckDB、Elasticsearch 或 ClickHouse 中以便高效查询,让 LLM 无需掌握 SQL 即可分析健康记录、生成统计并识别趋势。

主要能力:解析并导入 Apple Health XML 导出;支持自然语言查询健康数据;支持 DuckDB、Elasticsearch、ClickHouse 三种后端;提供结构化数据分析与趋势检测;支持 Docker 部署。

使用方式:需 Python 3.10+、Apple Health 导出 XML 文件及兼容 MCP 的客户端。克隆仓库后执行 pip install -e . 安装依赖,创建 .env 配置 APPLE_HEALTH_EXPORT_PATH、STORAGE_BACKEND 等变量,运行 python -m apple_health_mcp_server.import_data 导入数据,再在 MCP 客户端配置中注册服务器。也可用 docker build -t apple-health-mcp-server . 构建并挂载卷运行。

可用 MCP 工具:analyze_structure 分析导出结构与数据类型;search_records 按 record_type、start_date、end_date、limit、source_name、unit 过滤搜索;get_records_by_type 提取指定类型全部记录;generate_statistics 按 daily、weekly、monthly 聚合生成统计;analyze_trends 识别趋势与模式。

适用场景:个人健康数据探索、活动与心率等指标统计、月度活动汇总、趋势分析,以及通过 Python API 直接解析、存储、查询或导出 CSV/Parquet。

限制:需先拥有 Apple Health 导出 XML;日期须为 ISO 8601(YYYY-MM-DD)格式;大数据集查询性能依赖所选后端;导入内存不足时可减小 IMPORT_BATCH_SIZE。具体收费与价格信息暂未提供。