neiltron/apple-health-mcp

Local-first Apple Health MCP server. Lets AI assistants answer questions about your sleep, workouts, activity and heart data from a local export.

해결하는 문제

이 프로젝트는 AI 어시스턴트(MCP 클라이언트)가 개인의 Apple Health 데이터를 안전하게 쿼리하고 분석할 수 있도록 합니다. 건강 지표의 정적 CSV 내보내기와 LLM 사이의 격차를 메우며, 사용자가 클라우드 서비스에 파일을 업로드하지 않고도 자신의 데이터를 기반으로 건강 요약을 생성하고 분석 쿼리를 실행할 수 있게 해줍니다.

작동 방식

서버는 로컬에서 실행되는 Model Context Protocol (MCP) 서버로 작동합니다. DuckDB를 사용하여 "Simple Health Export CSV" 앱에서 생성한 CSV 내보내기를 읽습니다. AI 클라이언트가 데이터를 요청하면 서버는 관련 CSV 파일을 메모리 내 데이터베이스에 로드하여 LLM이 사용자의 로컬 건강 기록을 기반으로 SQL 기반 분석을 수행하고 보고서를 생성할 수 있도록 합니다.

대상 사용자

자신의 Apple Health 데이터 경향과 요약을 AI로 분석하고 싶지만, 원시 데이터는 자신의 컴퓨터에 로컬로 보관하고 싶은 개인을 위한 것입니다.

주요 특징

  • 로컬 처리: 파일을 그 자리에서 읽고 원시 데이터를 업로드하기 위한 네트워크 요청을 하지 않습니다.
  • SQL 기반 분석: health_query 도구를 통해 DuckDB를 사용하여 효율적인 분석 쿼리를 수행합니다.
  • 스키마 탐색: AI가 사용 가능한 테이블, 컬럼, 단위를 이해할 수 있도록 health_schema 도구를 포함합니다.
  • 자동 보고서 생성: 주간, 월간 또는 사용자 정의 건강 요약을 생성하는 health_report 도구를 제공합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트